# Suverse World Bank Poverty Headcount Ratio API

> Suverse World Bank Poverty Headcount Ratio API is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.07/call, status unknown (last checked 2026-09-15).

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.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-wb-poverty-headcount
- Price: $0.07/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-world-bank-poverty-headcount-ratio-api-b535c1a3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MIzzR5D_EcRCnb5uNGGor

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 suverse-world-bank-poverty-headcount-ratio-api-b535c1a3 -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## 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/suverse-world-bank-poverty-headcount-ratio-api-b535c1a3/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)