The International Database (IDB) APIs include demographic measures of over 200 countries and areas with populations of 5,000 or more. For each country and area, data in the IDB include total population, population by age and sex, and demographic characteristics such as fertility, mortality, and migration. Population size (by single year of age and sex) and components of change (fertility, mortality, and migration) are available from an initial or base year through 2100 for July 1 of each calendar year.

Read more information about the International Database population estimates and projections.

• International Database Single Year API Call: api.census.gov/data/timeseries/idb/1year.html
• Geography: api.census.gov/data/timeseries/idb/1year/geography.html
• Variables: api.census.gov/data/timeseries/idb/1year/variables.html
• Example Calls:

Show population by single year of age and sex for Botswana and Norway in 2023 and 2024: 

api.census.gov/data/timeseries/idb/1year?get=NAME,GENC,POP&YR=2023,2024&AGE=0:100&SEX=0,1,2&for=genc+standard+countries+and+areas:BW,NO&key=YOUR_KEY_GOES_HERE

Show female population aged 15-49 by single year of age for China, India, and Nigeria from 2023-2033: 

api.census.gov/data/timeseries/idb/1year?get=NAME,GENC,POP&YR=2023:2033&AGE=15:49&SEX=2&for=genc+standard+countries+and+areas:CN,IN,NG&key=YOUR_KEY_GOES_HERE

(includes fertility, mortality, and migration indicators)

• International Database 5-Year API Call: api.census.gov/data/timeseries/idb/5year.html
• Geography: api.census.gov/data/timeseries/idb/5year/geography.html
• Variables: api.census.gov/data/timeseries/idb/5year/variables.html
• Example Calls:

Show all variables for Botswana and Norway in 2023: 

api.census.gov/data/timeseries/idb/5year?get=NAME,GENC,group(IDB5YEAR)&YR=2023&for=genc+standard+countries+and+areas:BW,NO&key=YOUR_KEY_GOES_HERE

Show all variables for Pakistan and Angola at all ADM1 levels from 2015-2020: 

api.census.gov/data/timeseries/idb/5year?get=NAME,group(IDB5YEAR)&for=administrative%20division%20(first%20order):*&in=genc%20standard%20countries%20and%20areas:PK,AO&YR=2015:2020&key=YOUR_KEY_GOES_HERE

Show total population, total fertility rate, and life expectancy at birth for Pakistan’s Balochistan (ADM1 level 001) from 2015-2020: 

api.census.gov/data/timeseries/idb/5year?get=NAME,POP,TFR,E0&for=administrative%20division%20(first%20order):001&in=genc%20standard%20countries%20and%20areas:PK&YR=2015:2020&key=YOUR_KEY_GOES_HERE

Show total population, total fertility rate, and life expectancy at birth for Pakistan’ Balochistan (ADM1 level 001) at all ADM2 levels from 2015-2020: 

api.census.gov/data/timeseries/idb/5year?get=NAME,POP,TFR,E0&for=administrative%20division%20(second%20order):*&in=genc%20standard%20countries%20and%20areas:PK%20administrative%20division%20(first%20order):001&YR=2015:2020&key=YOUR_KEY_GOES_HERE

Show total population, total fertility rate, and life expectancy at birth for Pakistan’ Balochistan (ADM1 level 001) Kalat Division (ADM2 level 001) at all ADM3 levels from 2015-2020: 

api.census.gov/data/timeseries/idb/5year?get=NAME,POP,TFR,E0&for=administrative%20division%20(third%20order):*&in=genc%20standard%20countries%20and%20areas:PK%20administrative%20division%20(first%20order):001%20administrative%20division%20(second%20order):001&YR=2015:2020&key=YOUR_KEY_GOES_HERE

Show total population, total fertility rate, and life expectancy at birth for Pakistan’ Balochistan (ADM1 level 001) Kalat Division (ADM2 level 001) Awaran District (ADM3 level 001) at all ADM4 levels from 2015-2020: 

api.census.gov/data/timeseries/idb/5year?get=NAME,POP,TFR,E0&for=administrative%20division%20(fourth%20order):*&in=genc%20standard%20countries%20and%20areas:PK%20administrative%20division%20(first%20order):001%20administrative%20division%20(second%20order):001%20administrative%20division%20(third%20order):001&YR=2015:2020&key=YOUR_KEY_GOES_HERE

Topic: Estimate Variable

SEX: Sex

Dataset: 1year

0. Both
1. Male
2. Female