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}, 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 |
# 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, and daily mandi prices by market in Wholesale prices.