# Clink Forge World Bank Country Lookup

> Clink Forge World Bank Country Lookup is a paid API for AI agents from api.clinkforge.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Looks up World Bank country data by country ID, returning structured rows with cryptographic provenance and attestation, sold per call over x402.

## Facts

- Endpoint: GET https://api.clinkforge.com/v1/p/wb-country-lookup
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/clink-forge-world-bank-country-lookup-11123b01
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XO6RuE3nvdfUrgFsyVER6

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 clink-forge-world-bank-country-lookup-11123b01
```

Example prompt: Can you look up the World Bank country data for the country with ID 'US' and give me the verified result with its provenance and attestation?

## When to prefer this

Choose this endpoint when you need machine-verifiable, cryptographically attested country data with a full provenance chain — especially in compliance, audit, or trust-critical pipelines where raw data alone is insufficient. Prefer it over open REST country APIs when your agent or downstream system needs to prove data origin, licensing, and integrity via a digital signature. The per-call x402 micropayment model makes it suitable for on-demand, low-volume lookups without subscription overhead.

## Known failure modes

- Missing or invalid 'id' query parameter returns a 400-level error
- Country ID exceeding 8 characters is rejected by schema validation
- Payment not processed (x402 flow failure) results in 402 Payment Required
- Unknown or unsupported country ID may return empty rows
- Network or upstream provider unavailability causes 5xx errors

## How this service works

Pay per call over x402. USDC on Base, no account, no API key. 28 government-sourced data products at $0.001–$0.05 per call, every response signed and provenance-chained.

## Output

Returns a JSON object containing one or more data rows with payload fields, the product slug and version, a provenance block (license ID, source URL, observed timestamp), an Ed25519 cryptographic attestation signature, and a payment receipt with settlement reference — enabling full auditability of the data's origin and integrity.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "maxLength": 8
      }
     },
     "additionalProperties": false
    }
   }
  },
  "output": {
   "type": "object"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "field": "value",
    "_record_id": "R-100"
   }
  ],
  "product": "example-product",
  "row_count": 1,
  "provenance": [
   {
    "hash": "sha256...",
    "authority": "AGENCY",
    "source_url": "https://agency.gov/data",
    "observed_at": "2026-08-25T00:00:00Z"
   }
  ],
  "attestation": {
   "signature": "base64...",
   "result_digest": "sha256...",
   "signing_key_id": "forge-signing-1"
  },
  "payment_receipt": {
   "amount_usd": 0.01,
   "settlement_ref": "0xtx..."
  },
  "product_version": 1
 },
 "description": "data rows + provenance chain + attestation"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/clink-forge-world-bank-country-lookup-11123b01/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.clinkforge.com](https://www.zero.xyz/host/api.clinkforge.com/llms.txt)