# World Bank Population Time Series by Country

> World Bank Population Time Series by Country is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Returns total population as a yearly time series for any country, looked up by ISO country code, sourced from World Bank Open Data.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-e2e-worldbank-population
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/world-bank-population-time-series-by-country-299219b6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HtitOLCe0VTiejb6mRbPs

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability world-bank-population-time-series-by-country-299219b6 -d '<json body>'
```

Example prompt: Can you pull the World Bank population time series for Brazil — I need the yearly total population figures so I can size the addressable market?

## When to prefer this

Choose this endpoint when you need authoritative, World Bank-sourced total population data for any country as a historical yearly time series, especially for market sizing, demographic analysis, or economic research. Prefer this over ad-hoc web scraping or less authoritative sources when data provenance and consistency matter. Best suited for agents that need structured, machine-readable population data without requiring an API key.

## Known failure modes

- Invalid or unrecognized ISO country code returns an error or empty result
- Country with no World Bank data coverage returns empty time series
- Malformed POST body or missing required fields returns a 400-level error
- Payment failure via x402 protocol returns 402 Payment Required
- Upstream World Bank API unavailability causes timeout or 5xx error

## How this service works

Total population for any country by ISO code as a yearly time series from World Bank Open Data, no key: country, year, population. For AI agents sizing markets and demographics. Pipeline auto-index verification endpoint.

## Output

A yearly time series of total population figures for the requested country, identified by ISO country code, sourced from World Bank Open Data. Each record includes the country identifier, year, and total population count.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/world-bank-population-time-series-by-country-299219b6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)