---
title: "Ondemand Quote Subnational"
method: POST
path: "/ondemand/quote-subnational"
---

# Ondemand Quote Subnational

`POST /ondemand/quote-subnational`

## Request

- Base URL: `https://panafricadata.com` (the document declares no server; this is the origin it was published from)
- URL: `https://panafricadata.com/ondemand/quote-subnational`
- Auth: none declared
- TypeScript: <https://skmtc.dev/panafricadata/apis/pan-africa-data-api/docs/ondemand/quote-subnational/post.ts> (a function with typed inputs; its response is checked against the schema)

On-demand quote + checkout across the three geography layers:
  national  -> subnational admin_level 0
  city      -> functional_city_income (functional cities / economic sheds)
  locality  -> subnational admin_level 2  (formerly labelled 'City')
Each layer at its own rate: national $0.25, city $0.50, locality $0.15 per cell.
Age bands (age_levels: national and/or city) can be added to the same order at
$0.25 per cell; they arrive as a separate "Age bands" spreadsheet.
Honours the customer's layer, income-class and currency selections.

## Request body

- SubnationalOnDemandQuoteRequest
  - `countries` string[], required
  - `year_from` integer
  - `year_to` integer
  - `layers` string[], nullable
  - `admin_levels` integer[], nullable
  - `income_classes` string[], nullable
  - `currency` string, nullable
  - `currencies` string[], nullable
  - `age_levels` string[], nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-31** `522087b83249`: 3 info
  - added the new optional request property `currencies`
  - the `currency` request property default value `usd` was removed
  - request property `currency` list-of-types was widened by adding types `null` to media type `application/json`
- **2026-10-25** `05c7ed0515f2`: 1 info
  - added the new optional request property `age_levels`
- **2026-07-31** `3e6fe9c27d40`: 4 info
  - added the new optional request property `admin_levels`
  - added the new optional request property `currency`
  - added the new optional request property `income_classes`
  - added the new optional request property `layers`

[Operation history](https://skmtc.dev/panafricadata/apis/pan-africa-data-api/changes/ondemand/quote-subnational/post.md)

---

[API](https://skmtc.dev/panafricadata/apis/pan-africa-data-api.md) - [All operations](https://skmtc.dev/panafricadata/apis/pan-africa-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/panafricadata/apis/pan-africa-data-api/revisions/1803a1857b20?raw)