---
title: "Dashboard Download Subnational"
method: POST
path: "/api/dashboard/download-subnational"
---

# Dashboard Download Subnational

`POST /api/dashboard/download-subnational`

Sub-national download — emails Excel + CSV of income distribution for one or more countries.
Wide format: one row per region/city/urban-rural-total split, income classes as columns,
fixed household income bands per urban/rural split, legend at bottom of sheet.

## Cookies

- `pad_session` string

## Request body

- SubnationalDownloadRequest
  - `country_codes` string[], required
  - `year_from` integer, nullable
  - `year_to` integer, nullable
  - `include_forecasts` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/panafricadata/apis/pan-africa-data-api.md) · [All operations](https://skmtc.net/panafricadata/apis/pan-africa-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/panafricadata/pan-africa-data-api/revisions/3e6fe9c27d40/schema)