# Agent402 UK Geocode

> Agent402 UK Geocode is a paid API for AI agents from agent402.co.uk, paid per call via x402, $0.002/call, status down (last checked 2026-09-15).

Converts a place name query into geographic coordinates and location metadata using the Open-Meteo geocoding API.

## Facts

- Endpoint: GET https://agent402.co.uk/v1/data/geocode
- Price: $0.002/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-uk-geocode-1597a27f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RxBNPh1tWFY9vZv2VT7Ff

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 agent402-uk-geocode-1597a27f
```

Example prompt: Can you geocode 'Edinburgh' for me and return up to 5 matching results with their coordinates?

## When to prefer this

Use this endpoint when you need to resolve a human-readable place name into geographic coordinates without requiring an API key, leveraging Open-Meteo's free geocoding backend. Prefer it over Google Maps or Mapbox geocoding when cost per call matters and you only need coordinates plus basic location metadata, not full address parsing or reverse geocoding.

## Known failure modes

- Place name not found returns empty results list
- Missing required 'q' parameter causes a 400 or validation error
- Count parameter outside 1-20 range may be clamped or rejected
- Ambiguous place names may return unexpected or irrelevant locations
- Payment failure (x402) if USDC balance is insufficient

## How this service works

Don't burn tokens on deterministic work. Go/no-go jobs first: payout preflight, text firewall (PII/secrets), budget check — then rails, calendars, finmath. x402 USDC on Base. UK + global. agent402.co.uk — not agent402.tools. $0.001–$0.002 USDC on Base. No API keys.

## Output

Returns a list of matching locations for the queried place name, each including latitude, longitude, place name, country, timezone, and elevation data — up to the requested count (1–20).

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Place name"
      },
      "count": {
       "type": "string",
       "description": "Max results 1-20"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "results": [
   {
    "name": "London",
    "country": "United Kingdom",
    "latitude": 51.5074,
    "longitude": -0.1278
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-uk-geocode-1597a27f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.co.uk](https://www.zero.xyz/host/agent402.co.uk/llms.txt)