# World Bank Country Search

> World Bank Country Search is a paid API for AI agents from world-bank.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-24).

Search and filter World Bank countries by name fragment, region, or income group, returning ISO codes, capitals, and classification metadata.

## Facts

- Endpoint: GET https://world-bank.x402tookit.com/country-search?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/world-bank-country-search-2062f4cf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_b6eSqf18WRIoNXHR3UfNN

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-country-search-2062f4cf
```

Example prompt: Can you find all countries with 'south' in their name and tell me their ISO codes, capitals, and World Bank income groups?

## When to prefer this

Use this endpoint when you need to discover or enumerate countries matching a name pattern, World Bank region, or income group classification. It is ideal for building country lists, enriching datasets with ISO codes and capitals, or filtering countries by development classification. Prefer this over the country profile endpoint when you don't have an exact country name or ISO code and need to search or browse. Prefer this over the demographics or indicator endpoints when you only need identity and classification metadata, not economic or social time-series data.

## Known failure modes

- No matching countries found for the given query — returns an empty countries array with count 0
- Invalid or unrecognized region/income group fragment — may return empty results rather than an error
- Missing all query parameters — may return all countries or an error depending on API behavior
- Service degraded flag set to true — data may be incomplete or stale
- Network timeout or upstream World Bank API unavailability

## How this service works

Find countries by name fragment, World Bank region or income group, with ISO codes and capitals.

## Output

Returns a list of matching countries, each with ISO2 and ISO3 codes, official name, World Bank region, capital city, and income group classification. Also includes a count of results, data source attribution, and an 'asOf' timestamp indicating data freshness.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "q": {
       "type": "string",
       "description": "Name fragment, e.g. south"
      },
      "income": {
       "type": "string",
       "description": "Income group fragment: Low, Lower middle, Upper middle, High"
      },
      "region": {
       "type": "string",
       "description": "Region fragment, e.g. Africa, Europe, Latin"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "count": {
       "type": [
        "null",
        "number"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "countries": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "iso2": {
          "type": [
           "null",
           "string"
          ]
         },
         "iso3": {
          "type": [
           "null",
           "string"
          ]
         },
         "name": {
          "type": [
           "null",
           "string"
          ]
         },
         "region": {
          "type": [
           "null",
           "string"
          ]
         },
         "capital": {
          "type": [
           "null",
           "string"
          ]
         },
         "incomeGroup": {
          "type": [
           "null",
           "string"
          ]
         }
        }
 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/world-bank-country-search-2062f4cf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from world-bank.x402tookit.com](https://www.zero.xyz/host/world-bank.x402tookit.com/llms.txt)