# ForgeMesh Country Info API

> ForgeMesh Country Info API is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-13).

Returns a normalized JSON object with comprehensive country metadata (capital, ISO codes, currencies, languages, calling code, region, area, borders, flag emoji) for any country identified by name or 2/3-letter code.

## Facts

- Endpoint: POST https://x402.forgemesh.io/country-info
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-country-info-api-ff756ff9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iU2nVdA-t7YbHQyOGIzwM

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 forgemesh-country-info-api-ff756ff9 -d '<json body>'
```

Example prompt: Look up all the country info for Japan — I need the capital, ISO codes, currency, languages, calling code, region, area, land borders, and flag emoji in one go.

## When to prefer this

Choose this endpoint when you need a fast, single-call, all-in-one country metadata lookup without building your own database. It is ideal for form localization, compliance screens, shipping rules, and data enrichment pipelines where you need multiple country attributes (capital, codes, currencies, languages, borders) in one normalized response and sub-millisecond latency is important.

## Known failure modes

- Unrecognized country name or code returns an error or empty result
- Ambiguous partial names may not resolve correctly
- Territories or disputed regions may not be included
- Misspelled country names may fail to match

## How this service works

Country information API: capital, ISO codes, currencies, languages, calling code, region, area, land borders, and flag emoji for any country by name or 2/3-letter code — one normalized JSON object, answered locally in milliseconds. For form localization, compliance screens, shipping rules, and data-enrichment agents.

## Output

A single normalized JSON object containing the country's capital city, ISO 2-letter and 3-letter codes, currencies, official languages, international calling code, geographic region, land area, list of bordering countries, and flag emoji — resolved locally in milliseconds.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "country": {
   "type": "string",
   "description": "name or code, e.g. Japan"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cca2": "JP",
  "flag": "🇯🇵",
  "name": "Japan",
  "region": "Asia",
  "capital": [
   "Tokyo"
  ],
  "currencies": {
   "JPY": {
    "name": "Japanese yen",
    "symbol": "¥"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-country-info-api-ff756ff9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)