# Agent and developer data API Canonical: https://www.pluraterra.com/developers/ Page last materially revised: 2026-11-02 Observation periods are specified in the content; the revision date is not the data year. # Data for agents and developers Public, read-only JSON and CSV access to captured country indicators and specialised evidence. Current release: 2026-11-02-r3. No API key or paid add-on is required. [Dataset catalogue](https://www.pluraterra.com/api/v1/catalog) · [OpenAPI 3.1](https://www.pluraterra.com/openapi.json) · [Agent discovery file](https://www.pluraterra.com/llms.txt) · [Release manifest and hashes](https://www.pluraterra.com/data/releases/2026-11-02-r3/manifest.json) ## Start with a pinned querycurl 'https://www.pluraterra.com/api/v1/observations?country=PRT&indicator=life,air&from=2020&to=2025&release=2026-11-02-r3&limit=100' Responses contain meta, data and links. Follow links.next until null. Pagination links pin the resolved release, including when the first request used “current”. This prevents a later release from changing a paginated retrieval midstream. ## Query endpoints | Endpoint | Dataset filters | | --- | --- | | /api/v1/observations | country, indicator, provider, year, from, to, latest | | /api/v1/households | country, scenario, year | | /api/v1/regions | country, geo, indicator, year | | /api/v1/financial-strain | country, household, income_group, year | | /api/v1/passport-routes | origin, destination, category | | /api/v1/rankings | country | | /api/v1/robustness | country | | /api/v1/countries | country, region | | /api/v1/indicators | indicator, provider | | /api/v1/sources | id, area, q | All query endpoints accept release, limit (1–1000, default 100), offset (default 0), and format=json|csv. Country lists use comma-separated ISO3 codes. Duplicate and unsupported parameters are rejected. The catalogue accepts release and metadata search q. ## Periods, dimensions and meaning Observation rows carry a source code, unit, provider, original source URL, retrieval date, period start/end, observation type and dimensions. WHR rows are three-year survey means. OECD tax observations are explicit model households, not median residents. ILO hours are model estimates, not free time. Passport routes are conditional legal summaries with incomplete coverage, not a worldwide power ranking. latest=true selects the latest endpoint within supplied filters per country and indicator. These endpoints can differ. Fixed-year queries do not fill missing years. Missing observations are omitted; absent legal routes are unreviewed/unknown. A null interval or status flag means it has not been ingested, not that error is zero. ## CSV and caching Add format=csv or send Accept: text/csv. Nested fields use JSON inside CSV cells. CSV pagination and total counts are exposed through Link, X-Total-Count and X-Pluraterra-Release headers. JSON has equivalent metadata in its envelope. ETags, conditional GET, HEAD and public CORS are supported. Use bulk immutable snapshots for large retrievals rather than many tiny requests. ## Immutable downloads - [Country indicator observations](https://www.pluraterra.com/data/releases/2026-11-02-r3/atlas.json) · 153,424 records · SHA-256 02174125b4cac6f73f4e1b527627d1556448abff0673609d0837b6b66346f4d5 - [Household tax and net-income scenarios](https://www.pluraterra.com/data/releases/2026-11-02-r3/households.json) · 304 records · SHA-256 f4799e13bd4c0711caf06865ae1992d872f173573bf8f0b4c43348df29814c94 - [Subnational conditions](https://www.pluraterra.com/data/releases/2026-11-02-r3/regions.json) · 290 records · SHA-256 761c0476d8b5570d9af58fd3bd28d7293e59d673ee83f7b2d7c0cabe73a855c7 - [Reported financial strain](https://www.pluraterra.com/data/releases/2026-11-02-r3/financial-strain.json) · 1,731 records · SHA-256 02d80c02c9cc2ddf4e351523fb7bce82a1194183cbb839e474bc21b135405cfd - [Citizenship mobility opportunities](https://www.pluraterra.com/data/releases/2026-11-02-r3/passport-routes.json) · 725 records · SHA-256 3861bba61b87263eeebac6e7917d7339c9687282ee91365cb6176f9c55c796fe - [Experimental prosperity rankings](https://www.pluraterra.com/data/releases/2026-11-02-r3/rankings.json) · 170 records · SHA-256 0a68aaec389ea5d6dd3ba98499716aa9c1576f41dc969b2ecbc586868451e852 - [Weight-sensitivity calculations](https://www.pluraterra.com/data/releases/2026-11-02-r3/robustness.json) · 170 records · SHA-256 73ae3f2f9b02750d220334777eaa03b0a8ae17b264779e87c71aa92df20bf462 - [Source discovery catalogue](https://www.pluraterra.com/data/releases/2026-11-02-r3/sources.json) · 46 records · SHA-256 3fab15826f4a6e5f6e9bdcd068359490a6914c037ac240ad4733f89fb720dda0 - [Metric reliability and freshness](https://www.pluraterra.com/data/releases/2026-11-02-r3/reliability.json) · 47 records · SHA-256 47cc22979fe00b9b698c1836b08c575568ff5cacedaa37124b88f539ec7aa1a8 ## Attribution and source terms Preserve the returned release, dataset citation, original provider and source URL. The combined collection does not carry a blanket licence overriding provider rights. [Eurostat reuse](https://ec.europa.eu/eurostat/help/copyright-notice), [World Bank dataset terms](https://www.worldbank.org/en/about/legal/terms-of-use-for-datasets), [OECD terms](https://www.oecd.org/en/about/terms-conditions.html), [ILO permissions](https://www.ilo.org/rights-and-permissions) and [WHR data sharing](https://www.worldhappiness.report/data-sharing/) remain relevant. Candidate sources in the catalogue are not automatically ingested or cleared for redistribution. ## Errors and operational limits 400 means a malformed or unsupported query, 404 an unknown dataset/release, and 503 a captured snapshot could not load. Errors use application/problem+json. This is an initial service on one Basic dyno; no high-volume SLA is offered. Responses do not perform live provider fetches or calculate personal tax or immigration eligibility. ## What makes an answer reproducible? Record the exact release and query, follow all pages, retain the snapshot SHA-256, preserve units/dimensions and cite both Pluraterra and the original provider. Distinguish source estimates, normative index calculations, survey confidence intervals and weight-sensitivity ranges. Discovery files improve access; they do not guarantee that an AI system will cite the site.