Retrieve IDMC Data

Retrieves the data on Internally displaced persons due to conflict and violence that is produced by the Internal Displacement Monitoring Centre (IDMC).; Retrieves the data on Internally displaced persons due to conflict and violence that is produced by the Internal Displacement Monitoring Centre.; Fetch IDMC (Internal Displacement Monitoring Centre) displacement data with various filtering and pagination options.

byUNHCR Refugee Statistics API

200+calls

N/Alatency

Updated: Oct 27, 2026, 12:40 AM

Continue setup in your AI

Only public catalog IDs and a safe return path are handed to the Plugins page. This does not run the tool or confirm current availability, authorization, price, limits, or upstream status; those conditions are checked again before execution.

Selected tool: unhcr-refugee-statistics-api.idmc.retrieve.v1.c7f55f5f
Provider scope: UNHCR Refugee Statistics API
Catalog updated: 2026-10-27T00:40:01.989419+00:00
Business task: Pending verification

Continue setupYou can return to this tool page if the selection is incomplete or expires.

Run on this page: Execute is the in-site test path. Continue setup is for adding the public selection to an external AI; the two paths are tracked and validated separately.

Discover -> Inspect -> Call

Call setup

Tool IDunhcr-refugee-statistics-api.idmc.retrieve.v1.c7f55f5f

Request parametersJSON

Before this Call

1 credit / call

The final charge is settled from actual provider usage and will appear in Usage.

Field reference

pageintegerOptional

If pagination is available, send the number of page you wish to fetch.

limitintegerOptional

The numbers of items to return.

yearFromintegerOptional

The start year from which results will be filtered. The data results are inclusive of the given year (e.g. 2010 would result in data from and including 2010 up until the latest year, or the year specified in yearTo).

yearTointegerOptional

The end year up to which results will be filtered. The data results are inclusive of the given year (e.g. 2015 would result in data up to and including 2015 back through the available data, or the year specified in yearFrom).

yeararrayOptional

Send array of years.

downloadbooleanOptional

Get the result as a CSV file.

coostringOptional

Filter the data to one or more countries of origin. The countries are specified using the three character country codes (e.g., AFG for Afghanistan). Use a comma separated list to filter to multiple countries (e.g. “AFG,PAK”) or use the array notation e.g. “coo[]=AFG&coo[]=PAK”. By default, UNHCR’s country codes are used. To use three character ISO codes instead, see the cfType parameter. See the lookup between UNHCR and ISO3 country codes, including also the regions. If not specified, data for this dimension will be summed and aggregated to one row.

coastringOptional

Filter the data to one or more countries of asylum. The countries are specified using the three character country codes (e.g., AFG for Afghanistan). Use a comma separated list to filter to multiple countries (e.g. “AFG,PAK”) or use the array notation e.g. “coo[]=AFG&coo[]=PAK”. By default, UNHCR’s country codes are used. To use three character ISO codes instead, see the cfType parameter. See the lookup between UNHCR and ISO3 country codes, including also the regions. If not specified, data for this dimension will be summed and aggregated to one row.

coo_allbooleanOptional

Automatically includes all countries of origin in the response if set to “true”. If set, this overrides the specific selection of countries provided to CoO.

coa_allbooleanOptional

Automatically includes all countries of asylum in the response if set to “true”. If set, this overrides the specific selection of countries provided to CoA.

cf_typestringOptional

If set to “ISO” will cause the searches by origin and asylum to use the ISO3 codes. See the summary lookup table between UNHCR and ISO codes.

Retrieve IDMC Data

200+calls

N/Alatency

Updated: Oct 27, 2026, 12:40 AM

Continue setup in your AI

Selected tool

unhcr-refugee-statistics-api.idmc.retrieve.v1.c7f55f5f

Provider scope

UNHCR Refugee Statistics API

Catalog updated

2026-10-27T00:40:01.989419+00:00

Business task

Pending verification

Continue setupYou can return to this tool page if the selection is incomplete or expires.