Sync

Listar marcações de aulas

Devolve as marcações de aulas, ordenadas por id (da mais antiga para a mais recente). Só devolve marcações válidas (as de bilhete inválido são excluídas); as canceladas também são devolvidas, com status canceled. Sem updated_since devolve todas (sincronização inicial); com updated_since só as alteradas desde essa data, incluindo o cancelamento da aula inteira. Requer o plano Enterprise e o scope bookings:read.

get/v1/bookings

Request

  • Base URL: https://api-public.mvf.pt
  • URL: https://api-public.mvf.pt/v1/bookings
  • Auth: HTTP bearer

Query parameters

club_idstring
Example:clb_1

Só os registos deste clube. Tem de ser um clube a que a API key tem acesso. Em /v1/staff e /v1/membership-plans, os registos sem clube (comuns a todos os clubes) são sempre incluídos.

updated_sincestring date-time
Example:2026-10-07T00:00:00Z

Só os registos alterados depois desta data (ISO 8601). Um valor sem fuso horário (ex: 2026-10-07T08:00:00) e uma data sem hora (ex: 2026-10-07) são interpretados como UTC. Recomendamos enviar sempre em UTC com Z (ex: 2026-10-07T08:00:00Z). Usa a hora de início da sincronização anterior menos uma margem de segurança (ver Sincronização de dados).

limitinteger

Número máximo de registos por página.

cursorstring

O next_cursor da página anterior.

Response

Uma página de marcações de aulas.

Example response

{
  "data": [
    {
      "id": "bkg_456",
      "member_id": "mbr_1000",
      "club_id": "clb_1",
      "booked_at": "2026-10-07T19:30:00.000Z",
      "class": {
        "modality_id": "mod_12",
        "start": "2026-10-08T18:00:00.000Z",
        "end": "2026-10-08T18:50:00.000Z",
        "trainer_id": "stf_7"
      },
      "updated_at": "2026-10-07T19:30:00.000Z"
    }
  ],
  "pagination": {
    "next_cursor": "eyJhZnRlciI6MTAwfQ"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.