# PadelMaps Bulk Clubs by Country

> PadelMaps Bulk Clubs by Country is a paid API for AI agents from padelmaps.org, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-14).

Returns all active padel clubs in a given country with full field details including location, facilities, and contact info

## Facts

- Endpoint: POST https://padelmaps.org/api/x402/clubs/bulk
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/padelmaps-bulk-clubs-by-country-1c864c31
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_H5FpgI2oK4CITJ5zq4AdO

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-bulk-clubs-by-country-1c864c31 -d '<json body>'
```

Example prompt: Can you pull the full list of all active padel clubs in Spain from PadelMaps, including their addresses, facilities, and contact details?

## When to prefer this

Use this endpoint when you need a comprehensive, country-wide snapshot of all active padel clubs rather than searching city-by-city. Ideal for market research, building directories, or seeding a database. Prefer this over the city-level endpoint when you need national coverage in a single call.

## Known failure modes

- Invalid or unsupported country code returns an error or empty result
- Country not covered by PadelMaps returns empty dataset
- Payment failure via x402 protocol blocks access
- Rate limiting if called too frequently
- Stale data if clubs have recently closed or opened

## How this service works

Get all active clubs in a country with full fields

## Output

A bulk dataset of all active padel clubs in the specified country, each record containing full fields such as club name, address, GPS coordinates, available courts, facilities, contact details, and operating status.

## 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": [
      "country"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "description": "Max results (default: 1000, max: 5000)"
      },
      "country": {
       "type": "string",
       "description": "Country slug, e.g., 'spain'. Call /api/x402/countries ($0.01) for valid slugs and club counts."
      }
     }
    },
    "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": {
      "clubs": {
       "type": "array",
       "description": "id, name, address, coordinates, phone, website, rating, court counts, public_url"
      },
      "count": {
       "type": "integer",
       "description": "Clubs returned in this response"
      },
      "total": {
       "type": "integer",
       "description": "Clubs available; compare with count to detect truncation"
      },
      "fields": {
       "type": "string",
       "description": "'core' for this tier, 'full' for /clubs/bulk/full"
      },
      "country": {
       "type": "string"
      },
      "truncated": {
       "type": "boolean"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/padelmaps-bulk-clubs-by-country-1c864c31/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)