Reference

Listar colaboradores

Devolve os colaboradores do ginásio (vendedores, treinadores, nutricionistas, gestores e manutenção), ordenados por id. Os colaboradores sem clube são sempre incluídos. denied_club_ids lista os clubes a que o utilizador ativo do colaborador não tem acesso ([] se não houver). updated_at é o mais recente entre o colaborador e o seu utilizador ativo. Sem updated_since devolve todos (sincronização inicial); com updated_since só os alterados desde essa data. Requer o plano Enterprise e o scope staff:read.

get/v1/staff

Request

  • Base URL: https://api-public.mvf.pt
  • URL: https://api-public.mvf.pt/v1/staff
  • 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 colaboradores.

Example response

{
  "data": [
    {
      "id": "stf_7",
      "name": "Ana Costa",
      "email": "ana.costa@example.pt",
      "mobile_phone": "961234567",
      "role": "trainer",
      "active": true,
      "club_id": "clb_1",
      "denied_club_ids": [
        "clb_3"
      ],
      "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.