Fortitude21 Jerry Cans API

The Jerry Cans API from Fortitude21 — 1 operation(s) for jerry cans.

GitHub OpenAPI

Operations 2

GET /api/jerry-cans Water or fuel quantity in jerry cans #
POST /api/jerry-cans Water or fuel quantity in jerry cans (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-jerry-cans-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-jerry-cans-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: Jerry Cans
paths:
  /api/jerry-cans:
    get:
      operationId: jerryCanQuantity
      summary: Water or fuel quantity in jerry cans
      description: 'Water: people x days x litres a day. The default scenario, relief, is the Sphere minimum of 15 L a person a day with hygiene; for a household drinking store use survival (3 L) or a national code. Fuel: distance and consumption, hours and consumption, or generator kVA. Returns litres and jerry cans.'
      parameters:
      - name: mode
        in: query
        required: false
        schema:
          type: string
          description: water (default) or fuel
          enum:
          - water
          - fuel
        description: water (default) or fuel
      - name: scenario
        in: query
        required: false
        schema:
          type: string
          description: 'Water: relief, acute, protracted, survival, nl, se, no, fi, dk, de, custom. Fuel: road, overland, marine, generator, agri, direct'
        description: 'Water: relief, acute, protracted, survival, nl, se, no, fi, dk, de, custom. Fuel: road, overland, marine, generator, agri, direct'
      - name: people
        in: query
        required: false
        schema:
          type: number
          description: 'Water: number of people'
        description: 'Water: number of people'
      - name: days
        in: query
        required: false
        schema:
          type: number
          description: 'Water: number of days'
        description: 'Water: number of days'
      - name: weeks
        in: query
        required: false
        schema:
          type: number
          description: 'Water: number of weeks, if no days'
        description: 'Water: number of weeks, if no days'
      - name: distance
        in: query
        required: false
        schema:
          type: number
          description: 'Fuel: km (miles with units=us)'
        description: 'Fuel: km (miles with units=us)'
      - name: consumption
        in: query
        required: false
        schema:
          type: number
          description: 'Fuel: L/100 km (distance) or L/h (time); with units=us, miles per US gallon or US gallons an hour'
        description: 'Fuel: L/100 km (distance) or L/h (time); with units=us, miles per US gallon or US gallons an hour'
      - name: hours
        in: query
        required: false
        schema:
          type: number
          description: 'Fuel: running hours'
        description: 'Fuel: running hours'
      - name: kva
        in: query
        required: false
        schema:
          type: number
          description: Generator rated kVA
        description: Generator rated kVA
      - name: units_n
        in: query
        required: false
        schema:
          type: number
          description: Vehicles, boats or machines
        description: Vehicles, boats or machines
      - name: volume
        in: query
        required: false
        schema:
          type: number
          description: Fuel volume you already know
        description: Fuel volume you already know
      - name: reserve
        in: query
        required: false
        schema:
          type: number
          description: Margin in per cent
        description: Margin in per cent
      - name: units
        in: query
        required: false
        schema:
          type: string
          description: us for miles and US gallons
        description: us for miles and US gallons
      - name: rate
        in: query
        required: false
        schema:
          type: number
          description: 'Water, custom scenario: litres a person a day'
        description: 'Water, custom scenario: litres a person a day'
      - name: load
        in: query
        required: false
        schema:
          type: number
          description: 'Generator scenario: load in per cent, with kva'
        description: 'Generator scenario: load in per cent, with kva'
      - name: returnTrip
        in: query
        required: false
        schema:
          type: string
          description: 'Fuel, overland scenario: 1 to count the return leg'
          enum:
          - '0'
          - '1'
        description: 'Fuel, overland scenario: 1 to count the return leg'
      - name: can
        in: query
        required: false
        schema:
          type: string
          description: A product slug from our range to size in, e.g. product-20l-stainless-water-can
        description: A product slug from our range to size in, e.g. product-20l-stainless-water-can
      - 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/jerryCanQuantity'
        '400':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/RateLimited'
      x-openai-isConsequential: false
      tags:
      - Jerry Cans
    post:
      operationId: jerryCanQuantityPost
      summary: Water or fuel quantity in jerry cans (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:
                mode:
                  type: string
                  description: water (default) or fuel
                  enum:
                  - water
                  - fuel
                scenario:
                  type: string
                  description: 'Water: relief, acute, protracted, survival, nl, se, no, fi, dk, de, custom. Fuel: road, overland, marine, generator, agri, direct'
                people:
                  type: number
                  description: 'Water: number of people'
                days:
                  type: number
                  description: 'Water: number of days'
                weeks:
                  type: number
                  description: 'Water: number of weeks, if no days'
                distance:
                  type: number
                  description: 'Fuel: km (miles with units=us)'
                consumption:
                  type: number
                  description: 'Fuel: L/100 km (distance) or L/h (time); with units=us, miles per US gallon or US gallons an hour'
                hours:
                  type: number
                  description: 'Fuel: running hours'
                kva:
                  type: number
                  description: Generator rated kVA
                units_n:
                  type: number
                  description: Vehicles, boats or machines
                volume:
                  type: number
                  description: Fuel volume you already know
                reserve:
                  type: number
                  description: Margin in per cent
                units:
                  type: string
                  description: us for miles and US gallons
                rate:
                  type: number
                  description: 'Water, custom scenario: litres a person a day'
                load:
                  type: number
                  description: 'Generator scenario: load in per cent, with kva'
                returnTrip:
                  type: string
                  description: 'Fuel, overland scenario: 1 to count the return leg'
                  enum:
                  - '0'
                  - '1'
                can:
                  type: string
                  description: A product slug from our range to size in, e.g. product-20l-stainless-water-can
                lang:
                  type: string
                  description: en or ja
                  enum:
                  - en
                  - ja
      responses:
        '200':
          $ref: '#/components/responses/jerryCanQuantity'
        '400':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/RateLimited'
      tags:
      - Jerry Cans
components:
  responses:
    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.
    jerryCanQuantity:
      description: The answer
      content:
        application/json:
          schema:
            type: object
            properties:
              ok:
                type: boolean
              tool:
                type: string
                description: The tool page showing this answer
              total_l:
                type: number
                description: Litres to hold, margin included
              cans:
                type: number
                description: Number of jerry cans
              can:
                type: object
                additionalProperties: true
              working:
                type: string
                description: The arithmetic behind the figure
              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
  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