# PennyRail Country Metadata Lookup

> PennyRail Country Metadata Lookup is a paid API for AI agents from pennyrail.vercel.app, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Looks up machine-readable metadata for a given country by name or code

## Facts

- Endpoint: POST https://pennyrail.vercel.app/api/p/network/country.lookup--country-metadata
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pennyrail-country-metadata-lookup-295013dd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AgO6ND_a5vjzMODlwT-Ja

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 pennyrail-country-metadata-lookup-295013dd -d '<json body>'
```

Example prompt: Can you look up the country metadata for Germany — things like its official name, region, and any other structured details?

## When to prefer this

Use this endpoint when you need structured, machine-readable metadata for a country given a name or code, especially within a paid x402 micropayment workflow. Prefer this over free public APIs when already operating within the PennyRail settlement infrastructure or when consistent machine-readable output format is required.

## Known failure modes

- Unrecognized or misspelled country name/code returns an error or empty result
- Ambiguous input string may resolve to unexpected country
- Service unavailability returns HTTP 402 or 5xx error
- Malformed input object missing required 'input' field returns a validation error

## How this service works

Machine-readable settlement service

## Output

Returns a JSON object containing machine-readable metadata about the specified country, potentially including official name, ISO codes, region, subregion, and other geographic attributes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pennyrail-country-metadata-lookup-295013dd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pennyrail.vercel.app](https://www.zero.xyz/host/pennyrail.vercel.app/llms.txt)