# geocode.agentutil.net Forward Geocoding

> geocode.agentutil.net Forward Geocoding is a paid API for AI agents from geocode.agentutil.net, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14, last successful call 2026-06-07).

Converts a human-readable address or place name into geographic coordinates (latitude/longitude)

## Facts

- Endpoint: POST https://geocode.agentutil.net/v1/forward
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Last successful call: 2026-06-07
- Success rate: 100% of calls made through Zero
- Activations on Zero: 26
- Tags: x402
- Canonical page: https://www.zero.xyz/c/geocode-agentutil-net-d3dccf2b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_45vEC4xiLl5k9fQKMsxBy

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 geocode-agentutil-net-d3dccf2b -d '<json body>'
```

Example prompt: What are the latitude and longitude coordinates for 1600 Pennsylvania Avenue NW, Washington, DC? Give me up to 3 results.

## When to prefer this

Use this endpoint when you need to convert a free-text address or place name into geographic coordinates and are operating in an x402 micropayment context. Ideal for enriching location data, preparing coordinates for mapping APIs, or resolving place names to lat/lng for downstream geospatial operations.

## Known failure modes

- Address not found or too ambiguous — returns empty results or error
- Limit parameter out of range (must be 1-5) — returns validation error
- Malformed or missing address field — returns bad request error
- Network or service timeout — returns connection error
- Payment failure via x402 — returns 402 Payment Required

## How this service works

Convert address to coordinates

## Output

Returns up to the requested number of geocoded results (1-5), each containing geographic coordinates (latitude and longitude) corresponding to the input address or place name.

## Example request

```json
{
 "limit": 3,
 "address": "1600 Pennsylvania Avenue NW, Washington, DC"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number",
   "description": "Max results (1-5, default 1)"
  },
  "address": {
   "type": "string",
   "description": "Address or place name to geocode"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "results",
  "service",
  "request_id",
  "related_services"
 ],
 "properties": {
  "results": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "lat",
     "lon",
     "type",
     "importance",
     "display_name"
    ],
    "properties": {
     "lat": {
      "type": "number"
     },
     "lon": {
      "type": "number"
     },
     "type": {
      "type": "string"
     },
     "importance": {
      "type": "number"
     },
     "display_name": {
      "type": "string"
     }
    }
   }
  },
  "service": {
   "type": "string"
  },
  "request_id": {
   "type": "string"
  },
  "related_services": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "url",
     "name",
     "description"
    ],
    "properties": {
     "url": {
      "type": "string"
     },
     "name": {
      "type": "string"
     },
     "description": {
      "type": "string"
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/geocode-agentutil-net-d3dccf2b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from geocode.agentutil.net](https://www.zero.xyz/host/geocode.agentutil.net/llms.txt)