Sync

Listar sócios

Devolve os sócios do ginásio, ordenados por id (do mais antigo para o mais recente). Sem updated_since devolve todos (sincronização inicial); com updated_since só os alterados desde essa data, incluindo mudanças de estado. Requer o plano Enterprise e o scope members:read.

get/v1/members

Request

  • Base URL: https://api-public.mvf.pt
  • URL: https://api-public.mvf.pt/v1/members
  • 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 sócios.

Example response

{
  "data": [
    {
      "id": "mbr_1000",
      "customer_code": "C-1000",
      "club_id": "clb_1",
      "name": "Carlos Alberto Silva Vilaça",
      "short_name": "Carlos Vilaça",
      "email": "cv@example.com",
      "phone": "253000000",
      "mobile_phone": "961234567",
      "birthday": "2006-01-21",
      "gender": "male",
      "address": {
        "line": "Rua Exemplo 12",
        "city": "Guimarães",
        "postal_code": "4800-001"
      },
      "status": "active",
      "tags": [
        "PT",
        "GUIMARÃES"
      ],
      "consents": {
        "data_processing": true,
        "marketing": false
      },
      "trainer_id": "stf_7",
      "nutritionist_id": null,
      "salesperson_id": "stf_3",
      "discount_id": null,
      "subscribe_reason_id": "rsn_2",
      "cancellation_reason_id": null,
      "lead_id": null,
      "updated_at": "2026-10-08T08:00:00.000Z"
    }
  ],
  "pagination": {
    "next_cursor": "eyJhZnRlciI6MTAwfQ"
  }
}

Changes

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