# Country Facts by Name or ISO Code

> Country Facts by Name or ISO Code is a paid API for AI agents from bess-x402.onrender.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-28).

Returns comprehensive country facts (official name, capital, region, languages, currencies, calling code, borders, area, TLD, coordinates, UN membership, flag) given a country name or ISO-2/ISO-3 code.

## Facts

- Endpoint: GET https://bess-x402.onrender.com/v1/geo/country?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/country-facts-by-name-or-iso-code-f7e32427
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hlrF548mgnsz-2_3zgZyy

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 country-facts-by-name-or-iso-code-f7e32427
```

Example prompt: Can you look up the full country facts for Germany — I need its official name, capital, calling code, currency, languages, internet TLD, and which countries it borders?

## When to prefer this

Use this endpoint when you need rich, structured reference data about a country from a single lookup — especially when enriching forms, datasets, or user profiles with multiple country attributes at once. Prefer it over manual geocoding or Wikipedia scraping when you need standardized fields like ISO codes, calling codes, TLD, and UN membership in one call.

## Known failure modes

- Unknown or misspelled country name returns an error or empty result
- Ambiguous partial name may not resolve correctly
- Rate limiting or payment failure if USDC balance is insufficient
- Server unavailability on render.com free tier cold starts

## How this service works

Facts about a country by name or ISO code: official name, capital, region, languages, currencies, calling code, borders, area, internet TLD, coordinates, UN membership and flag. Use to enrich addresses, forms and datasets.

## Output

A structured JSON object containing the country's official name, capital, geographic region, list of languages, currencies, international calling code, list of bordering countries, total area in km², internet TLD, geographic coordinates (latitude/longitude), UN membership status, and flag (emoji or URL).

## 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",
       "description": "Country name or ISO-2/ISO-3 code"
      }
     }
    }
   },
   "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/country-facts-by-name-or-iso-code-f7e32427/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bess-x402.onrender.com](https://www.zero.xyz/host/bess-x402.onrender.com/llms.txt)