# Provinces & districts

The granular layer: every district (and, for the census, every tehsil, taluka and sub-division) in one API. 32 series from the **Pakistan Bureau of Statistics**.

| | |
|---|---|
| Module | `regional` |
| Frequency | Census (2023, 2024) and survey years (LFS, HIES) |
| Endpoint | [`/v1/series/{id}`](https://pakdatahub.com/docs/api-series.md), filtered with `dims` |

Each series covers every area at once. Pick one with `dims`: `province` (Punjab, Sindh, Khyber Pakhtunkhwa, Balochistan, Islamabad), `district` (absent on province rows) and, where it applies, `subdistrict` + `unit_type`, `locality` (total, rural, urban) and `sex` (all, male, female, transgender). Names are PBS's own, in title case ("Rahim Yar Khan", "Kambar Shahdad Kot"); see a series' values without `dims` to list them.

## Census 2023 (7th Population & Housing Census)

Dated 2023-12-31; enumeration ran March to May 2023. Province, district and sub-district rows (tehsil, taluka, sub-division, sub-tehsil). Balochistan nests sub-tehsils inside tehsils, so don't add up sub-district rows.

| Id | What it is | Extra dims |
|---|---|---|
| `regional.census.population` | Population | `locality`, `sex` |
| `regional.census.population_2017` | 2017 census population of the same area | `locality` |
| `regional.census.growth_rate` | Average annual growth 2017-2023, % | `locality` |
| `regional.census.area` - `.density` - `.urban_share` | Sq km, persons per sq km, urban % | |
| `regional.census.sex_ratio` - `.household_size` | Males per 100 females, persons per household | `locality` |
| `regional.census.literacy_rate` | Literate share of population aged 10+, % | `locality`, `sex` |
| `regional.census.out_of_school` | Children aged 5-16 not in school | `locality`, `sex` |

District totals add up exactly to each province's figure (Punjab 127,688,922; Pakistan 241.5 million with Islamabad).

## Economic Census 2023

Pakistan's first economic census: every establishment, by PSIC section (`sector`, e.g. "Manufacturing", "Wholesale and retail trade; repair of motor vehicles and motorcycles", or "All sectors"). Pakistan had 7,142,941 establishments employing 25,344,121 people.

| Id | What it is | Extra dims |
|---|---|---|
| `regional.econ_census.establishments` | Number of establishments | `sector` |
| `regional.econ_census.workforce` | Persons working in them | `sector` |
| `regional.econ_census.establishments_by_size` | Establishments with fewer than 10 / 10 or more workers | `sector`, `size` |

## Agricultural Census 2024

Sample-weighted estimates, rounded to whole numbers. Province and district rows, dated 2024-12-31.

| Id | What it is | Extra dims |
|---|---|---|
| `regional.agri_census.livestock` | Animals by type | `animal`: cattle, buffaloes, sheep, goats, camels, horses, mules, asses, yak/dzo/dzomo |
| `regional.agri_census.farms` - `.farm_area` - `.cultivated_area` | Private farms, their area and cultivated area (acres) | `farm_size` ("all", "under 1.0", "1.0 to under 2.5" ... acres) |
| `regional.agri_census.tractors` | Tractors | `ownership`: all, individual, joint, cooperative |
| `regional.agri_census.tubewells` | Tubewells and lift pumps | `kind`, `power`: all, electric, solar, diesel, petrol, other |

## Labour Force Survey (by province)

2024-25 under the current 19th ICLS definitions, plus 2020-21 and 2024-25 under the older 13th ICLS (comparable with each other): `standard` = "19th ICLS" or "13th ICLS". Dated at the survey year's end (30 June). Pakistan rows have no `province`.

`regional.lfs.unemployment_rate` (7.1% in 2024-25; 10.5% for women), `.participation_rate`, `.employment_to_population` (%), and `.employed`, `.unemployed`, `.labour_force`, `.out_of_labour_force`, `.working_age_population` (millions), each by `sex`.

## Household Integrated Economic Survey (HIES)

2018-19 and 2024-25 side by side, from the HIES 2024-25 report.

| Id | What it is | Dims |
|---|---|---|
| `regional.hies.household_income` | Average monthly household income, Rs (Rs 82,179 in 2024-25) | `locality`, `quintile` (1-5, all) |
| `regional.hies.household_consumption` | Average monthly household consumption, Rs | `locality`, `quintile` |
| `regional.hies.consumption_per_capita` | Monthly consumption per person, Rs | `locality`, `quintile` |
| `regional.hies.household_size` - `.earners_per_household` | Persons and earners per household | `locality` or `province` |

```bash
# Every district's population (one call), then one district
curl -H "X-API-Key: pk_live_xxx" \
  "https://api.pakdatahub.com/v1/series/regional.census.population?dims=locality:total,sex:all&limit=5000"
curl -H "X-API-Key: pk_live_xxx" \
  "https://api.pakdatahub.com/v1/series/regional.census.literacy_rate?dims=district:Lahore,locality:total,sex:female"
# Manufacturing establishments in Sialkot
curl -H "X-API-Key: pk_live_xxx" \
  "https://api.pakdatahub.com/v1/series/regional.econ_census.establishments?dims=district:Sialkot,sector:Manufacturing"
```

Related: national population and labour series from the SBP in [Population & society](https://pakdatahub.com/docs/data-social.md), and daily mandi prices by market in [Wholesale prices](https://pakdatahub.com/docs/data-agri-prices.md).

---
Source: https://pakdatahub.com/docs/data-regional - PakDataHub docs index: https://pakdatahub.com/docs/llms.txt