# Suverse World Bank Country Profile Lookup

> Suverse World Bank Country Profile Lookup 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-14).

Returns a country profile (region, income level, capital city, longitude, latitude) from the World Bank Open Data API given an ISO country code, with no API key required.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-worldbank-country
- Price: $0.07/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-world-bank-country-profile-lookup-01862971
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YtdhGW3mdD7RQQFNp8VU4

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-country-profile-lookup-01862971 -d '<json body>'
```

Example prompt: Pull up the World Bank country profile for Japan — I need its region, income classification, capital city, and geographic coordinates.

## When to prefer this

Prefer this endpoint when you need structured country-level metadata (region, income tier, capital, coordinates) keyed by ISO code without managing a World Bank API key. Ideal for macro-economic pipelines, geospatial enrichment workflows, or AI agents that need to augment country records with authoritative World Bank classifications in real time.

## Known failure modes

- Invalid or unrecognized ISO country code returns an error or empty result
- Malformed request body causes a 400-level error
- Upstream World Bank API unavailability causes degraded or failed response
- Payment not processed results in a 402 response before data is returned

## How this service works

Country profile from World Bank Open Data by ISO code, no key. Returns region, income level, capital city, longitude, and latitude. For AI agents enriching country context for macro and geo analysis.

## Output

A country profile object containing the country's World Bank region name, income level classification (e.g. Low income, Upper middle income), capital city name, and the country's centroid longitude and latitude coordinates.

## 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-country-profile-lookup-01862971/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)