# PadelMaps - Get All Padel Clubs in a City

> PadelMaps - Get All Padel Clubs in a City is a paid API for AI agents from padelmaps.org, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Returns a list of all padel clubs located in a specified city

## Facts

- Endpoint: POST https://padelmaps.org/api/x402/clubs
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/padelmaps-org-40f7e5b4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_np4s_vD5LOyKgcnog7hHl

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-40f7e5b4 -d '<json body>'
```

Example prompt: Can you find all the padel clubs in Barcelona for me?

## When to prefer this

Use this endpoint when you need a comprehensive directory of padel clubs in a specific city. Prefer this over general sports venue search APIs when the user is specifically looking for padel courts and venues. Best suited for travel planning, sports app integrations, or helping users find nearby padel facilities by city.

## Known failure modes

- City not found or unsupported — returns empty list or error
- City name ambiguous (multiple countries) — may return wrong results
- No padel clubs exist in the specified city — returns empty list
- Payment failure — x402 payment not processed, returns 402
- Invalid request format — missing city parameter returns 400 error

## How this service works

Discover and rate padel clubs around the world. Find the perfect padel court for your next game.

## Output

A list of padel clubs in the specified city, likely including club names, addresses, and other venue details such as contact info or court availability.

## Example request

```json
{
 "city": "Barcelona"
}
```

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json"
     ]
    },
    "body": {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "type": "object",
     "properties": {
      "city": {
       "type": "string",
       "description": "City name, e.g., 'barcelona'"
      },
      "country": {
       "type": "string",
       "description": "Country name to disambiguate cities (e.g., 'spain', 'mexico')"
      },
      "limit": {
       "type": "integer",
       "description": "Max results (default: 50, max: 100)"
      }
     },
     "required": [
      "city"
     ]
    }
   },
   "required": [
    "type",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "city": {
       "type": "string"
      },
      "count": {
       "type": "integer"
      },
      "clubs": {
       "type": "array",
       "description": "List of clubs with id, name, address, coordinates, rating"
      }
     }
    }
   }
  }
 },
 "required": [
  "input"
 ]
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/padelmaps-org-40f7e5b4/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)