# PennyRail Country Lookup

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

Looks up country information from a 2 or 3 letter country code, returning structured country data

## Facts

- Endpoint: POST https://pennyrail.vercel.app/api/f/country.lookup
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pennyrail-country-lookup-924ad232
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4KJ6Ka_zMJAgoZnYA_R3I

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-lookup-924ad232 -d '<json body>'
```

Example prompt: Can you look up the country details for the code 'DEU' and tell me what you get back?

## When to prefer this

Use this endpoint when you need a lightweight, pay-per-call country code resolution with no subscription or API key setup, and you only need occasional lookups. Ideal for agents that need to enrich or validate ISO 2-letter or 3-letter country codes inline during a workflow without integrating a full geolocation or reference data service.

## Known failure modes

- Invalid or unrecognized country code returns an error or empty result
- Missing 'input' field in request body causes a 400-level validation error
- Ambiguous code (e.g. a code that doesn't match any ISO standard) may return no result
- Network or service unavailability returns a 5xx error
- Malformed input (non-string or overly long value) may be rejected

## How this service works

Machine-readable settlement service

## Output

Returns a JSON object containing an 'operation' string describing what was performed and a 'result' field with the country data associated with the provided code. The response may include additional fields with country metadata such as name, region, or other structured details.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "string",
   "description": "2 or 3 letter country code"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "operation",
  "result"
 ],
 "properties": {
  "result": {},
  "operation": {
   "type": "string"
  }
 },
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pennyrail-country-lookup-924ad232/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)