# Suverse Country by Name Lookup

> Suverse Country by Name Lookup is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Look up a country by name and retrieve its capital, region, population, currencies, languages, and flag from REST Countries — no API key required.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-country-by-name
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-country-by-name-lookup-3b78fd21
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qgsvTOW6xO3gMLwHKdOM0

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 suverse-country-by-name-lookup-3b78fd21 -d '<json body>'
```

Example prompt: Can you look up country details for Germany — I need the capital, region, population, official currencies, languages spoken, and the flag?

## When to prefer this

Choose this endpoint when you need quick, keyless country metadata enrichment by name — ideal for AI agents that need to contextualize user-provided country strings with geographic, demographic, linguistic, and economic metadata without managing API credentials. Prefer over direct REST Countries calls when operating in an x402 micropayment context or when proxying is required.

## Known failure modes

- Country name not found or misspelled — returns empty results or error
- Ambiguous name matching multiple countries — may return unexpected result
- REST Countries upstream outage — endpoint becomes unavailable
- Malformed request body — returns validation error

## How this service works

Look up a country by name from REST Countries, no key. Returns capital, region, population, currencies, languages, and flags. For AI agents enriching country context.

## Output

Returns a structured object for the matched country including capital city, geographic region, population count, list of currencies with codes and symbols, official languages, and flag image URLs (PNG and SVG).

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "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/suverse-country-by-name-lookup-3b78fd21/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)