Fortitude21 Un Decode API

The Un Decode API from Fortitude21 — 1 operation(s) for un decode.

GitHub OpenAPI

Operations 2

GET /api/un-decode Decode a UN packaging mark #
POST /api/un-decode Decode a UN packaging mark (JSON body) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/fortitude21-com:fortitude21-com-un-decode-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

fortitude21-com-un-decode-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: 'Fortitude21 API: dangerous goods tools and product…'
  version: 1.1.0
  description: 'Free, keyless JSON API from Fortitude21, in two halves.


    The tools answer dangerous goods packaging questions from the regulations: the UN drums, jerricans and IBCs a UN number may use and the largest size of each (ADR 2025 Table A and its packing instructions), what a UN packaging mark means, IBC test and inspection dates, the ADR 1.1.3.6 small-load points, the bund capacity a store needs under a country''s rule, and jerry can quantities.


    The catalogue under /api/v1/ covers what Fortitude21 makes: steel, stainless, aluminium, tinplate and UN-rated HDPE jerry cans, pails, tins, drums, spill pallets, closures and handling equipment. Search and filter by material, capacity, certification and application, fetch one product in full, compare products on the attributes they all publish, read indicative pricing, list documentation, and send a quotation request.


    CORS is open and there is no key or sign-up. Every answer carries `cite` (credit it with a link) and `publisher`. The same tools are an MCP server at https://fortitude21.com/mcp.


    Two things to rely on: the catalogue is read-only, with no write path at any version, and any price is indicative and never a quotation. The quotation request creates an enquiry for a person to price, not an order. Tool answers are general information; check the rules for your own load.'
  contact:
    name: Fortitude21
    email: david@fortitude21.com
    url: https://fortitude21.com/dangerous-goods-api
  termsOfService: https://fortitude21.com/terms
  license:
    name: Free to use with credit to Fortitude21 and a link to the tool page
    url: https://fortitude21.com/terms
servers:
- url: https://fortitude21.com
tags:
- name: Un Decode
paths:
  /api/un-decode:
    get:
      operationId: decodeUnMark
      summary: Decode a UN packaging mark
      description: 'Read a UN packaging mark part by part: packaging code, performance level, density or gross mass, test pressure, year, state and maker; IBC, large packaging, salvage (T), special (V), equivalent (W) and reconditioned (R, RL) marks too. Add un= to check the container against a substance.'
      parameters:
      - name: mark
        in: query
        required: true
        schema:
          type: string
          description: The mark as printed, e.g. UN 3H1/Y1.9/150/26/D/BAM 12345
        description: The mark as printed, e.g. UN 3H1/Y1.9/150/26/D/BAM 12345
      - name: un
        in: query
        required: false
        schema:
          type: string
          description: Optional UN number to check the mark against
        description: Optional UN number to check the mark against
      - name: lang
        in: query
        required: false
        schema:
          type: string
          description: en or ja
          enum:
          - en
          - ja
        description: en or ja
      responses:
        '200':
          $ref: '#/components/responses/decodeUnMark'
        '400':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/RateLimited'
      x-openai-isConsequential: false
      tags:
      - Un Decode
    post:
      operationId: decodeUnMarkPost
      summary: Decode a UN packaging mark (JSON body)
      description: The same as GET, with the parameters as a JSON object.
      x-openai-isConsequential: false
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                mark:
                  type: string
                  description: The mark as printed, e.g. UN 3H1/Y1.9/150/26/D/BAM 12345
                un:
                  type: string
                  description: Optional UN number to check the mark against
                lang:
                  type: string
                  description: en or ja
                  enum:
                  - en
                  - ja
      responses:
        '200':
          $ref: '#/components/responses/decodeUnMark'
        '400':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/RateLimited'
      tags:
      - Un Decode
components:
  responses:
    decodeUnMark:
      description: The answer
      content:
        application/json:
          schema:
            type: object
            properties:
              ok:
                type: boolean
              tool:
                type: string
                description: The tool page showing this answer
              mark:
                type: string
                description: The mark as sent
              code:
                type: string
                description: The packaging code, e.g. 3H1
              spec:
                type: string
                description: The mark as read
              parts:
                type: array
                items:
                  type: object
                  properties:
                    part:
                      type: string
                      description: Name of the part
                    value:
                      type: string
                      description: The characters on the mark
                    meaning:
                      type: string
                      description: What they mean
              check:
                type: object
                additionalProperties: true
                description: 'With un=: each entry of that UN number with may_carry ok, viscous (viscous liquids only), combination (outer of a combination packaging), density (only if the liquid is no denser than the mark allows; see typical_relative_density) or no, and the reasons'
              cite:
                type: string
                description: Credit line and link to the same answer on fortitude21.com. Show it with the figures.
              docs:
                type: string
                description: Documentation for this endpoint
              assumed:
                type: array
                items:
                  type: string
                description: How the API read inputs it had to interpret (a substance name, a place, a date, a missing value), and parameters it ignored
              publisher:
                $ref: '#/components/schemas/Publisher'
            required:
            - ok
    Error:
      description: The input could not be read. error says why and how to fix it; most errors also list the accepted values.
      content:
        application/json:
          schema:
            type: object
            properties:
              ok:
                type: boolean
                const: false
              error:
                type: string
                description: Why the request could not be answered, and how to fix it
              docs:
                type: string
                description: Documentation for this endpoint
              covered_un_numbers:
                type: array
                items:
                  type: string
                description: 'un-packaging: the UN numbers the finder covers'
              valid_regions:
                type: array
                items:
                  type: string
                description: 'bund-size: the region ids accepted'
              valid_modes:
                type: array
                items:
                  type: string
                description: 'jerry-cans: the modes accepted'
              valid_scenarios:
                type: array
                items:
                  type: string
                description: 'jerry-cans: the scenarios accepted for the mode'
              candidates:
                type: array
                items:
                  type: object
                  additionalProperties: true
                description: 'un-packaging: entries a substance name matched; pass un= with one of them'
              issues:
                type: array
                items:
                  type: object
                  additionalProperties: true
                description: 'adr-points: each line that could not be read, and why'
              publisher:
                $ref: '#/components/schemas/Publisher'
            required:
            - ok
            - error
    RateLimited:
      description: More than about 10 requests in 10 seconds from one IP address. Wait 10 seconds, then retry.
  schemas:
    Publisher:
      type: object
      description: 'Fortitude21, the publisher: products that meet this answer and a quote link to pass to a user who needs containers'
      properties:
        name:
          type: string
          description: Fortitude21
        about:
          type: string
          description: Who publishes the API and what it makes
        sells_to:
          type: string
          description: 'Who can buy: businesses on quote with a minimum order, no retail checkout'
        contact:
          type: string
          description: Email for trade enquiries
        quote_url:
          type: string
          description: Pre-filled enquiry link, tagged with the tool it came from
        products:
          type: array
          items:
            type: object
            additionalProperties: true
externalDocs:
  description: Documentation with examples
  url: https://fortitude21.com/dangerous-goods-api