# CertainData Country Lookup

> CertainData Country Lookup is a paid API for AI agents from api.certaindata.ai, paid per call via x402, $0.007/call, status unknown (last checked 2026-09-15).

Look up a country by name, ISO code, or calling code and return standardized metadata including ISO codes, capital, region, subregion, and calling codes.

## Facts

- Endpoint: GET https://api.certaindata.ai/ca054d66abad4d6ea80ba43013b61743-cd/country-lookup/:input
- Price: $0.007/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/certaindata-country-lookup-b8c0e073
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_O-bJkQfSrUYvS5XVwF3px

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 certaindata-country-lookup-b8c0e073
```

Example prompt: Can you look up the country details for 'DE' — I need its official name, capital, region, subregion, and calling codes?

## When to prefer this

Use this endpoint when you need to resolve a country identifier (name, ISO code, or dialing code) into standardized country metadata such as ISO codes, capital, region, or subregion. Ideal for data enrichment pipelines, form validation, or any scenario requiring canonical country information from a flexible input format.

## Known failure modes

- Invalid or unrecognized country name, ISO code, or calling code returns an error or empty result
- Ambiguous input (e.g. partial name) may not resolve to a country
- Misspelled country names may not match
- Non-standard or deprecated ISO codes may not be recognized

## How this service works

Look up a country by name, ISO code, or calling code. Returns ISO codes, official name, capital, region, subregion, and calling codes.

## Output

Returns structured country metadata including ISO alpha-2 and alpha-3 codes, official country name, capital city, region (e.g. Europe), subregion (e.g. Western Europe), and international calling codes (e.g. +49).

## 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",
    "pathParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "input"
     ],
     "properties": {
      "input": {
       "type": "string",
       "description": "Country name, ISO code, or calling code to look up, e.g. Germany, DE, or +49."
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "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/certaindata-country-lookup-b8c0e073/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.certaindata.ai](https://www.zero.xyz/host/api.certaindata.ai/llms.txt)