Total fertility rate

GET

/api/v1/un-population/fertility

Last modified:2026-05-10 09:22:39

Maintainer:Not configured

OperationId:un_population_fertility

Total fertility rate (5-year averages) from UN DESA World Population Prospects 2024 indicator id 19 (TFR5). Value is the average number of live births per woman over her reproductive life span.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/un-population/fertility?location=USA&start_year=2020&end_year=2025' \
--header 'x-api-key: <api-key>'

Responses

🟢200

application/json

Total fertility rate rows by year.

Bodyapplication/json

Example

{
    "data": {
        "location_m49": 0,
        "location_input": "string",
        "indicator_ids": [
            0
        ],
        "start_year": 0,
        "end_year": 0,
        "variant_id": 0,
        "rows": [
            {
                "locationId": 0,
                "location": "string",
                "iso3": "string",
                "iso2": "string",
                "indicatorId": 0,
                "indicator": "string",
                "indicatorShortName": "string",
                "variantId": 0,
                "variant": "string",
                "sexId": 0,
                "sex": "string",
                "ageId": 0,
                "ageLabel": "string",
                "ageStart": 0,
                "ageEnd": 0,
                "categoryId": 0,
                "category": "string",
                "timeLabel": "string",
                "timeId": 0,
                "timeMid": 0,
                "year": 0,
                "value": 0,
                "unit": "string"
            }
        ],
        "total": 0
    },
    "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",
        "source": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true
    }
}

🟠401

🟠422

🟠429

🔴503

Modified at 2026-05-10 09:22:39

Total population

Life expectancy and mortality composite