# SignalDesk AI World Bank Country Data

> SignalDesk AI World Bank Country Data is a paid API for AI agents from x402-agent.kariguetoazul.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-13).

Fetches structured country metadata (region, capital, coordinates, income level) from the World Bank API for a given ISO country code.

## Facts

- Endpoint: GET https://x402-agent.kariguetoazul.workers.dev/api/data/worldbank-country?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/signaldesk-ai-world-bank-country-data-27df583c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_l9_2zw2G5FNKa2yuZv-81

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 signaldesk-ai-world-bank-country-data-27df583c
```

Example prompt: Pull the World Bank country profile for Portugal — I need its region, capital, income level, and coordinates.

## When to prefer this

Choose this endpoint when you need authoritative, structured country metadata (region, capital, coordinates, income level) sourced directly from the World Bank and cached for fast retrieval. Prefer it over raw World Bank API calls when you want a clean, normalized JSON response with a single ISO code lookup at very low cost ($0.002 USDC). Best for enriching datasets, validating country classifications, or resolving geographic metadata in agent workflows.

## Known failure modes

- Invalid or unsupported ISO country code returns an error or empty countries array
- Country code too short (under 2 chars) or too long (over 3 chars) fails schema validation
- World Bank upstream API unavailable causes a fetch error
- Payment not completed (x402 protocol) results in 402 response before data is returned
- Cached data may be up to 24 hours stale based on expires_at field

## How this service works

Evidence-backed autonomous AI jobs and paid data tools. Queue/D1/cron run outside the chat; free quotas and bounded execution apply.

## Output

A JSON object containing structured country data sourced from the World Bank, including the country's ISO ID and code, full name, world region, capital city, latitude, longitude, and income level classification. Also includes source metadata: provider name, license (CC BY 4.0), fetch timestamp, expiry timestamp, and the original World Bank API URL used.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "country"
     ],
     "properties": {
      "country": {
       "type": "string",
       "pattern": "^[A-Za-z]{2,3}$",
       "maxLength": 3,
       "minLength": 2,
       "description": "ISO country code."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "source": {
   "license": "CC BY 4.0 unless indicated otherwise by source",
   "provider": "World Bank",
   "expires_at": "2026-10-03T09:44:49.800Z",
   "fetched_at": "2026-10-02T09:44:49.800Z",
   "source_url": "https://api.worldbank.org/v2/country/PT?format=json",
   "transformed": true
  },
  "countries": [
   {
    "id": "PRT",
    "code": "PT",
    "name": "Portugal",
    "region": "Europe & Central Asia",
    "capital": "Lisbon",
    "latitude": "38.7072",
    "longitude": "-9.13552",
    "income_level": "High income"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/signaldesk-ai-world-bank-country-data-27df583c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-agent.kariguetoazul.workers.dev](https://www.zero.xyz/host/x402-agent.kariguetoazul.workers.dev/llms.txt)