---
title: "Water or fuel quantity in jerry cans"
method: GET
path: "/api/jerry-cans"
---

# Water or fuel quantity in jerry cans

`GET /api/jerry-cans`

## Request

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

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.

## Query parameters

- `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)