← Back to API Home

Availabilities API

Show Anybuddy court availabilities in your software and send players to the booking page

v2 · Read-only

The availabilities API is read-only and uses HTTP REST / JSON. You display free slots in your product; the player books and pays on Anybuddy through a link you build from each slot.

Getting started

Request an API key through the form on https://www.anybuddyapp.com/fr/pro/integrations#acces. You receive two keys:

Authentication

Send your key in the Authorization header of every request:

HTTP header
Authorization: Bearer ab_YOUR_KEY_HERE

Find centers

GET /v2/centers?query=…&city=…&activity=padel

Returns the centers matching your filters. Keep the centerId of each club you want to display.

Read availabilities

GET /v2/centers/{centerId}/availabilities?date.from=YYYY-MM-DDT00:00&date.to=YYYY-MM-DDT23:59&activities=padel&partySize=0
curl
curl "https://api.anybuddyapp.com/v2/centers/CENTER_ID/availabilities?date.from=2026-12-01T00:00&date.to=2026-12-01T23:59&activities=padel&partySize=0" \ -H "Authorization: Bearer ab_YOUR_KEY_HERE"
Warning: always use date.from and date.to. Do not use the date=a,b form: it does not return the expected range.

Good practices

Test environment

API: https://api.staging.anybuddyapp.com
Booking pages: https://app.staging.anybuddyapp.com

Use your test key against these hosts, then switch to your live key and https://api.anybuddyapp.com when you go live.

Build it with your AI assistant

Anybuddy exposes an MCP server so your coding assistant can read this documentation and query the API for you:

Claude Code
claude mcp add --transport http anybuddy https://mcp.anybuddyapp.com/mcp

Once you have your test key, pass it to the MCP server in the Authorization header to unlock the test tools (never paste it into the conversation):

Claude Code — with your test API key
claude mcp add --transport http anybuddy https://mcp.anybuddyapp.com/mcp --header "Authorization: Bearer ab_…"

Request your key through the access form.

Need help? Contact contact@anybuddyapp.com