Facebook Pixel
Fit'DistanceDocumentation
FREN
Ouvrir l'app

Rendez-vous

1 route

GET /appointments

Appointments of the coach with their participants. A guest appears without any identity. The coach's private notes are never served. A Google Calendar sync may move updated_at.

  • Périmètre appointments:read
  • 1 crédit
  • Lecture
  • Stable

Paramètres

NomTypeDescription
limitqueryinteger1–200, default 50
cursorquerystringOpaque cursor: next_cursor of the previous page.
sincequerydate-timeISO 8601. Returns the objects with updated_at >= since.
include_deletedquerybooleandefault false
student_idqueryinteger≥ 1
statusquerystringparmi : pending, confirmed, cancelled, completedOnly this status, for example cancelled.
curl "https://api.fitdistance.io/api/partner/v1/appointments?limit=50" \
  -H "Authorization: Bearer fd_live_xxxxxxxx"
200 · une page de Appointment
{
  "data": [
    {
      "id": "7c1d1e2a-9b3f-4c5d-8e6f-1a2b3c4d5e6f",
      "coach_id": 4821,
      "title": "string",
      "description": "string",
      "event_type": "appointment",
      "status": "pending",
      "start_at": "2026-10-24T09:12:00Z",
      "end_at": "2026-10-24T09:12:00Z",
      "duration_minutes": 45,
      "is_all_day": true,
      "color": "string",
      "prestation_name": "string",
      "cancelled_at": "2026-10-24T09:12:00Z",
      "cancellation_reason": "string",
      "participants": [
        {
          "student_id": 4821,
          "is_guest": true,
          "participation_status": "pending",
          "booking_source": "app",
          "registered_at": "2026-10-24T09:12:00Z",
          "cancelled_at": "2026-10-24T09:12:00Z"
        }
      ],
      "created_at": "2026-10-24T09:12:00Z",
      "updated_at": "2026-10-24T09:12:00Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}
403 · SCOPE_MISSING
{
  "error": {
    "name": "PARTNER_API",
    "message": "SCOPE_MISSING"
  }
}

200 · une page de Appointment

NomTypeDescription
id requisstring
coach_id requisinteger
title requisstring | nullNull when deleted.
description requisstring | nullNull when deleted.
event_type requisstringparmi : appointment, meeting, reminder, task, absence, other
status requisstringparmi : pending, confirmed, cancelled, completed
start_at requisdate-time
end_at requisdate-time
duration_minutes requisinteger | null
is_all_day requisboolean
color requisstring | null
prestation_name requisstring | nullThe name of the prestation booked, even a deleted one.
cancelled_at requisdate-time | null
cancellation_reason requisstring | nullNull when deleted.
participants requisAppointmentParticipant[]Guests and visible students, removed registrations excluded. Empty when deleted.
created_at requisdate-time
updated_at requisdate-timeThe latest change of the appointment or its participants, a cancellation or a deletion included. Also moves when its prestation changes (its name).
deleted_atdate-time | nullPresent when include_deleted is true.

Erreurs

StatutCodeQuand
400VALIDATIONParamètres ou corps invalides.facturé
401UNAUTHORIZEDClé absente, inconnue ou révoquée.non facturé
402CREDITS_EXHAUSTEDPlus de crédits ce mois-ci et aucune réserve.non facturé
403SCOPE_MISSINGLa clé n'a pas le périmètre demandé.non facturé
403PLAN_NOT_ELIGIBLETon offre n'ouvre pas l'API.non facturé
429RATE_LIMITEDTrop d'appels : 10 par seconde, 300 par minute, 60 écritures et 20 suppressions par minute.non facturé