# PadelMaps Geocoding API

> PadelMaps Geocoding API is a paid API for AI agents from padelmaps.org, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15, last successful call 2026-07-02).

Converts a street address string into geographic coordinates (latitude/longitude) with structured address components and place metadata

## Facts

- Endpoint: POST https://padelmaps.org/api/x402-tools/geocode
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Last successful call: 2026-07-02
- Success rate: 90% of calls made through Zero
- Activations on Zero: 21
- Tags: x402
- Canonical page: https://www.zero.xyz/c/padelmaps-org-6e0eeea3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cljoYgiMiABAbowt5wJur

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 padelmaps-org-6e0eeea3 -d '<json body>'
```

Example prompt: What are the latitude and longitude coordinates for 1600 Amphitheatre Parkway, Mountain View, CA?

## When to prefer this

Use this endpoint when you need to convert a human-readable street address into geographic coordinates (latitude/longitude) for use in mapping, routing, or location-based queries. Prefer this over reverse geocoding endpoints when the input is an address string rather than coordinates. Cost is $0.01 USDC per call via x402 micropayment protocol.

## Known failure modes

- Address not found or too ambiguous — returns empty results array
- Malformed address input — may return zero results or low-confidence matches
- Network timeout or service unavailability — HTTP 5xx error
- Payment failure — x402 payment not accepted, returns 402 status
- Missing required 'address' field in request body — returns 400 error

## How this service works

Convert address to coordinates

## Output

Returns a list of matching results for the address, each containing latitude, longitude, place type (e.g. 'commercial', 'it'), a human-readable display name, structured address fields (house number, road, city, county, state, postcode, country, country code), and an importance score indicating result confidence. Also returns the original query string and whether the result was served from cache.

## Example request

```json
{
 "address": "1600 Amphitheatre Parkway, Mountain View, CA"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "address"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "description": "Max results (default 5, max 10)"
      },
      "address": {
       "type": "string",
       "description": "Address or place name to geocode. Alias: 'query'. E.g. 'Eiffel Tower, Paris'"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "count": {
       "type": "integer"
      },
      "query": {
       "type": "string"
      },
      "cached": {
       "type": "boolean"
      },
      "results": {
       "type": "array"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/padelmaps-org-6e0eeea3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from padelmaps.org](https://www.zero.xyz/host/padelmaps.org/llms.txt)