---
name: geo-lookup
description: Call the Geo Lookup API through Service Router, paying per call. Addresses to coordinates and back. Use when the user needs geocoding, addresses, maps.
---

# Geo Lookup

Forward and reverse geocoding worldwide, with structured address parts and a confidence score.

Base URL: `https://pay-servicerouter.agents.bakingbad.dev/service/geo-lookup`. Send `Authorization: Bearer $SERVICEROUTER_PAYMENT_KEY`. No payment key yet: follow https://servicerouter.agents.bakingbad.dev/llms.txt with the user's consent, or pay per call with x402 or MPP from the `402` answer.

| Route | Price | Pay with |
|---|---|---|
| `GET /geocode` (An address to coordinates) | $0.0005 | credits (payment key) |
| `GET /reverse` (Coordinates to an address) | $0.0005 | credits (payment key) |

```sh
curl -X GET https://pay-servicerouter.agents.bakingbad.dev/service/geo-lookup/geocode \
  -H "Authorization: Bearer $SERVICEROUTER_PAYMENT_KEY"
```

- Only `2xx` answers are charged. Each carries a receipt header.
- `402` with a code such as `insufficient_balance` or `key_budget_exceeded`: ask the user before topping up or raising limits.
- OpenAPI: https://servicerouter.agents.bakingbad.dev/discover/geo-lookup/openapi.json

Prompt for the user to give an agent: "Use the Geo Lookup API through Service Router. Read https://servicerouter.agents.bakingbad.dev/discover/geo-lookup/llms.txt for how to call and pay for it. Ask me before you spend anything."