International demography: single-year age x sex pyramid of one country

GET

/api/v1/census/population/international/{country}/pyramid

Last modified:2026-09-09 12:24:46

Maintainer:Not configured

OperationId:census_population_international_country_pyramid

Population by single year of age and sex from the Census Bureau's International Data Base (timeseries/idb/1year) for one GENC country in one year (1950 to 2100). Both-sexes totals (SEX=0) are dropped; male and female are kept. Age 100 is 100 years and over. An unknown two-letter code is an empty answer, not a 400.

Request

Path Params

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://sugra.ai/api/v1/census/population/international//pyramid?year=2026' \
--header 'x-api-key:   ABCD314159'

Responses

🟢200OK

application/json

One row per age and sex (male then female), in age order.

Bodyapplication/json

Example

{
    "data": {
        "country": "string",
        "name": "string",
        "year": 0,
        "dataset": "string",
        "count": 0,
        "data": [
            {
                "age": 0,
                "age_label": "string",
                "sex": "string",
                "pop": 0,
                "property1": "string",
                "property2": "string"
            }
        ],
        "source": "string",
        "reason": "string",
        "property1": "string",
        "property2": "string"
    },
    "meta": {
        "endpoint": "/api/v1/fred/us/cpi",
        "data_time": "2026-04-16T14:30:00Z",
        "response_time": "2026-04-16T14:30:12Z",
        "provider": "Sugra API v1.0.1",
        "data_age_days": 0,
        "source": "string",
        "attribution": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true,
        "stale": true,
        "stale_since": "string",
        "period": "string",
        "notes": "string"
    }
}

🟠401Unauthorized

🟠422Parameter Error

🟠429

🔴502Bad Gateway

🔴503Service Unavailable

🔴504Gateway Timeout

Modified at 2026-09-09 12:24:46

International demography: one year, every country

International demography: one country's series