# Resamania API Documentation

> Public partner API documentation for Resamania (by Xplor Technologies), a multi-tenant SaaS for managing fitness/sports clubs (CRM, access control, scheduling, online sales, billing). This documentation is for third-party developers integrating with the Resamania REST API.

Resamania's backend is a stateless REST API (Symfony / API Platform) secured with OAuth2. Starting **June 2026**, direct calls to the Resamania API will no longer be supported — partners must migrate to the **API Gateway** (see the Getting Started and API Gateway pages below). This documentation is also available in French under the `/fr/` prefix; content otherwise mirrors this English version page for page.

## Getting started
- [Getting started](https://doc.resamania.com/getting-started): Overview, becoming a partner, API Gateway migration notice
- [Glossary](https://doc.resamania.com/general/glossary): Core business vocabulary (member, subscription, club...)
- [API Gateway](https://doc.resamania.com/gateway/): Gateway migration guide, mandatory from June 2026
- [My application](https://doc.resamania.com/general/my-application): Registering and configuring a partner application
- [Developer resources](https://doc.resamania.com/general/ressources): Bruno/Postman collections and other integration resources
- [Webhooks](https://doc.resamania.com/webhooks/webhooks): Event subscription model, delivery, payload format

## For AI agents
- [Agent playbook](https://doc.resamania.com/for-agents): Start here if you are an AI coding agent building a partner integration — conventions, required headers, auth grant types, business workflow sequencing, and sensible defaults
- [Skill: pre-submission request review](https://doc.resamania.com/skills/pre-submission-review): Self-review checklist to run before requesting the test/recette phase — endpoint inventory, required-parameter check, PII/security audit, backend-only enforcement, client_credentials header check, workflow-sequencing check

## General principles
- [Security and partner responsibilities](https://doc.resamania.com/general/security)
- [Rate limiting](https://doc.resamania.com/general/rate-limiting)
- [Internationalisation](https://doc.resamania.com/general/internationalisation)
- [Changelog](https://doc.resamania.com/changelog)

## Authentication (OAuth2)
- [Authenticate](https://doc.resamania.com/auth/authentication): Overview of supported OAuth2 grant types
- ["code" method](https://doc.resamania.com/auth/code)
- ["password" method](https://doc.resamania.com/auth/password)
- ["http://clubclientcredentials" method](https://doc.resamania.com/auth/club-client-credentials)
- ["http://contactclientcredentials" method](https://doc.resamania.com/auth/contact-client-credentials)
- ["client_credentials" method](https://doc.resamania.com/auth/client-credentials)
- ["refresh_token" method](https://doc.resamania.com/auth/refresh-token)

## Club networks (multi-club)
- [Working with club chains](https://doc.resamania.com/multiclubs/networks)
- [Transfer a prospect between clubs](https://doc.resamania.com/multiclubs/transfer-a-prospect)
- [Free/open booking across a network](https://doc.resamania.com/multiclubs/free-booking)

## Contacts / members
- [Online registration](https://doc.resamania.com/contacts/subscription)
- [Consents / opt-ins](https://doc.resamania.com/contacts/optins)
- [Debts, incidents and closures](https://doc.resamania.com/contacts/incidents-and-closures)
- [Online cancellation](https://doc.resamania.com/contacts/cancellation)
- [Anonymisation](https://doc.resamania.com/contacts/anonymise): GDPR / UK GDPR data erasure

## Scheduling & booking
- [Retrieve the schedule](https://doc.resamania.com/booking/schedule)
- [Book a class](https://doc.resamania.com/booking/book-a-class)

## Sales
- [Sales glossary](https://doc.resamania.com/sale/glossary)
- [Sell to an existing contact](https://doc.resamania.com/sale/sell-to-existing-contact)
- [Product behaviors](https://doc.resamania.com/sale/product-behaviors)
- [Offer restrictions](https://doc.resamania.com/sale/offer-restrictions)
- [Direct debits: dates and amounts](https://doc.resamania.com/sale/dd-date-amount): SEPA (France) / BACS (UK)
- [Contract, mandate, signature](https://doc.resamania.com/sale/sign-contract-or-mandate)
- [Discount codes](https://doc.resamania.com/sale/add-discount-code)
- [Online payments](https://doc.resamania.com/sale/online-payments): Card registration and payment, Stripe and other PSPs

## API Reference (OpenAPI, one spec per business domain)
- [API Reference index](https://doc.resamania.com/api-reference/): entry point listing every domain below
- [Catalog](https://doc.resamania.com/api-reference/catalog): products, offers, product families/groups
- [Club](https://doc.resamania.com/api-reference/club): clubs, coaches, studios, access boxes
- [Contact](https://doc.resamania.com/api-reference/contact): members, identifiers, family links
- [Accounting](https://doc.resamania.com/api-reference/accounting)
- [Communication](https://doc.resamania.com/api-reference/communication)
- [Access control](https://doc.resamania.com/api-reference/access-control)
- [OAuth](https://doc.resamania.com/api-reference/oauth)
- [Partner](https://doc.resamania.com/api-reference/partner)
- [Planning / booking](https://doc.resamania.com/api-reference/planning)
- [Referential](https://doc.resamania.com/api-reference/referential)
- [Club network](https://doc.resamania.com/api-reference/club-network)
- [Sale](https://doc.resamania.com/api-reference/sale)

## Optional
- [French version](https://doc.resamania.com/fr/): identical documentation set, in French