---
title: "Water or fuel quantity in jerry cans (JSON body)"
method: POST
path: "/api/jerry-cans"
---

# Water or fuel quantity in jerry cans (JSON body)

`POST /api/jerry-cans`

## Request

- Base URL: `https://fortitude21.com`
- URL: `https://fortitude21.com/api/jerry-cans`
- Auth: none declared

The same as GET, with the parameters as a JSON object.

## Request body

- object
  - `mode` 'water' | 'fuel': water (default) or fuel
  - `scenario` string: Water: relief, acute, protracted, survival, nl, se, no, fi, dk, de, custom. Fuel: road, overland, marine, generator, agri, direct
  - `people` number: Water: number of people
  - `days` number: Water: number of days
  - `weeks` number: Water: number of weeks, if no days
  - `distance` number: Fuel: km (miles with units=us)
  - `consumption` number: Fuel: L/100 km (distance) or L/h (time); with units=us, miles per US gallon or US gallons an hour
  - `hours` number: Fuel: running hours
  - `kva` number: Generator rated kVA
  - `units_n` number: Vehicles, boats or machines
  - `volume` number: Fuel volume you already know
  - `reserve` number: Margin in per cent
  - `units` string: us for miles and US gallons
  - `rate` number: Water, custom scenario: litres a person a day
  - `load` number: Generator scenario: load in per cent, with kva
  - `returnTrip` '0' | '1': Fuel, overland scenario: 1 to count the return leg
  - `can` string: A product slug from our range to size in, e.g. product-20l-stainless-water-can
  - `lang` 'en' | 'ja': en or ja

## Response `200`

The answer

- object
  - `ok` boolean, required
  - `tool` string: The tool page showing this answer
  - `total_l` number: Litres to hold, margin included
  - `cans` number: Number of jerry cans
  - `can` object
  - `working` string: The arithmetic behind the figure
  - `cite` string: Credit line and link to the same answer on fortitude21.com. Show it with the figures.
  - `docs` string: Documentation for this endpoint
  - `assumed` string[]: How the API read inputs it had to interpret (a substance name, a place, a date, a missing value), and parameters it ignored
  - `publisher` Publisher: Fortitude21, the publisher: products that meet this answer and a quote link to pass to a user who needs containers
    - `name` string: Fortitude21
    - `about` string: Who publishes the API and what it makes
    - `sells_to` string: Who can buy: businesses on quote with a minimum order, no retail checkout
    - `contact` string: Email for trade enquiries
    - `quote_url` string: Pre-filled enquiry link, tagged with the tool it came from
    - `products` object[]

## Other responses

- `400`: The input could not be read. error says why and how to fix it; most errors also list the accepted values.
- `429`: More than about 10 requests in 10 seconds from one IP address. Wait 10 seconds, then retry.

---

[API](https://skmtc.dev/fortitude21/apis/fortitude21-dangerous-goods-and-packaging-api.md) · [All operations](https://skmtc.dev/fortitude21/apis/fortitude21-dangerous-goods-and-packaging-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fortitude21/apis/fortitude21-dangerous-goods-and-packaging-api/revisions/70ec29b02c48?raw)