{"uid":"cap_MIzzR5D_EcRCnb5uNGGor","slug":"suverse-world-bank-poverty-headcount-ratio-api-b535c1a3","name":"Suverse World Bank Poverty Headcount Ratio API","description":"Poverty Headcount Ratio for any country by ISO code as a yearly World Bank Open Data time series, no key. Returns country, year, and value. For AI agents doing macro, demographic, and cross country analysis.","url":"https://proxy.suverse.io/v1/data/suverse-wb-poverty-headcount","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.07","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.07/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.07","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.07","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uLFsL_FQ4Wat-gKUPjn7c","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.07","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the World Bank poverty headcount ratio time series for a given country by ISO code, with yearly data on the share of the population living below the poverty line.","exampleAgentPrompt":"Can you pull the World Bank poverty headcount ratio time series for India using its ISO country code — I need the full yearly breakdown to do a macro comparison?","exampleUseCases":[{"title":"Cross-country poverty trend comparison","prompt":"Get me the yearly poverty headcount ratio from the World Bank for Brazil, Nigeria, and India so I can compare their long-term poverty trends side by side."},{"title":"Country-level development report","prompt":"I'm writing a development economics report — can you fetch the full World Bank poverty headcount ratio time series for Bangladesh so I have all the yearly values?"},{"title":"Regional poverty analysis for investment research","prompt":"Pull the poverty headcount ratio data for Indonesia and the Philippines by year — I want to see how poverty rates have evolved in Southeast Asia for a macro investment brief."}],"resultDescription":"Returns a time series of poverty headcount ratio data for the requested country, including the country name, ISO code, each year with available data, and the corresponding ratio value (percentage of population living below the national poverty line), sourced from World Bank Open Data.","failureModes":["Invalid or unrecognized ISO country code returns an error or empty dataset","Countries with limited World Bank data coverage may return sparse or no values for certain years","Network or proxy timeout may result in a failed response","Incorrect body format or missing required fields returns a schema validation error"],"whenToPreferThis":"Use this endpoint when you need historical yearly poverty headcount ratio data for a specific country without requiring a World Bank API key. It is ideal for macroeconomic analysis, development research, cross-country comparisons, and demographic studies where structured time-series poverty data is needed quickly and without authentication overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:02:16.820Z","isFirstParty":false}