Developers

A public REST API for clubs and certified partners: scoped reads, bookings by API, and HMAC-signed webhooks.

Authentication

Every key is generated from the club panel, under Settings → Developers, and travels as a Bearer header.

curl -H "Authorization: Bearer mp_…" \
  https://api.meetandplay.mx/api/v1/clubs/{clubId}/bookings

The full key is only shown once. Store it somewhere safe.

Endpoints

Every key declares the scopes it was created with; a request without the required scope is refused.

GET/clubs/{clubId}/courts
The club's court catalogue.
GET/clubs/{clubId}/availability
Busy slots per court, up to 14 days.
GET/clubs/{clubId}/bookings
The club's bookings, newest first.
GET/clubs/{clubId}/customers
The club's customer directory — personal data, behind its own scope.
POST/clubs/{clubId}/bookings
Creates a booking, same as the club's own desk.
POST/clubs/{clubId}/bookings/{bookingId}/cancel
Cancels a booking; refunds or voids the payment per the club's policy.

Webhooks

Receive HMAC-SHA256 signed events at your own URL: booking created, confirmed or cancelled, payment succeeded, and match filled. Every delivery retries with backoff; after several failed attempts it lands in the dead-letter queue, redeliverable from the club panel.

Rate limits

Every key has a per-minute request cap. A 429 response means it was reached; slow down and retry.

Certified partners

A certified partner connects in one click from the club panel — no keys copied and pasted by hand.

Ready to integrate your club?

Go to the club panel OpenAPI specification