{"uid":"cap_QZchJ2VTq8jk9mkJQ8HVM","slug":"saylor-innovations-humanitarian-data-refugee-statistics-by-country-1d5e066b","name":"Saylor Innovations Humanitarian Data — Refugee Statistics by Country (UNHCR)","description":"Refugee Statistics by Country (UNHCR). Refugee statistics by country (UNHCR) for the latest published year: refugees, asylum seekers, internally displaced and stateless people originating from a country with its top host countries, and people hosted in it with their top countries of origin. ISO3 code (SYR, UKR, DEU). UNHCR, CC BY 4.0.","url":"https://saylorinnovations.com/api/refugees/country?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","POST","PUT","PATCH","DELETE","HEAD"],"type":"string"},"queryParams":{"type":"object","properties":{"code":{"type":"string","description":"ISO 3166 alpha-3 country code, e.g. SYR, UKR, DEU (query)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["found"],"properties":{"year":{"type":"number"},"found":{"type":"boolean"},"from_this_country":{"type":"object"},"hosted_in_this_country":{"type":"object"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5FF6vlo_f5eiqzGI5-YYo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns UNHCR refugee statistics for a given country by ISO3 code, including refugees, asylum seekers, IDPs, and stateless people both originating from and hosted in that country.","exampleAgentPrompt":"Can you pull the latest UNHCR refugee statistics for Syria — I want to know how many people have fled the country, how many are asylum seekers, and which countries are hosting the most Syrian refugees?","exampleUseCases":[{"title":"Refugee crisis research for Syria","prompt":"What does the UNHCR data say about refugees originating from Syria? I need the number of refugees, asylum seekers, and IDPs, plus the top host countries."},{"title":"Host country burden analysis for Germany","prompt":"Can you look up UNHCR data for Germany and tell me how many refugees it's currently hosting and where those refugees are coming from?"},{"title":"Stateless population report for Ukraine","prompt":"I need the latest UNHCR displacement figures for Ukraine — refugees, internally displaced people, and stateless persons — along with where Ukrainian refugees have ended up."}],"resultDescription":"A JSON object containing the most recently published UNHCR year of data, a boolean indicating whether the country was found, a 'from_this_country' object with refugee/asylum seeker/IDP/stateless counts and top host countries, and a 'hosted_in_this_country' object with hosted population totals and top countries of origin.","failureModes":["Invalid or unrecognized ISO3 country code returns found: false with empty data objects","Country exists but has no UNHCR displacement data returns found: true with zero counts","Missing required 'code' query parameter may return an error or empty result","Network or upstream UNHCR data source outage","Stale data if UNHCR has not yet published a new annual report"],"whenToPreferThis":"Use this endpoint when you need structured, country-level UNHCR humanitarian displacement statistics — including refugees, asylum seekers, IDPs, and stateless persons — for a specific country identified by ISO3 code. Prefer this over general web search when you need machine-readable, citable (CC BY 4.0) data with top host/origin country breakdowns, especially for agents building humanitarian dashboards, research reports, or policy analysis workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T12:52:01.803Z","isFirstParty":false,"canonicalSlug":"saylor-innovations-humanitarian-data-refugee-statistics-by-country-1d5e066b"}