Get members

Obter Membros

Descrição

Retorna uma lista de membros. Utilizado para acessar informações relacionadas aos alunos da academia, podendo aplicar filtros diversos por nome, documento, datas de registro, status, entre outros.

Parâmetros da Consulta

ParâmetroTipoObrigatórioDescrição
namestringNãoFiltra os membros pelo nome.
emailstringNãoFiltra os membros pelo e-mail.
documentstringNãoFiltra os membros pelo número do documento.
phonestringNãoFiltra os membros pelo telefone ou celular. Ex.: 1112341234
conversionDateStartdate-timeNãoFiltra os membros pela data de conversão inicial. (Formato: yyyy-mm-dd)
conversionDateEnddate-timeNãoFiltra os membros pela data de conversão final. (Formato: yyyy-mm-dd)
registerDateStartdate-timeNãoFiltra os membros pela data de cadastro inicial. (Formato: yyyy-mm-dd)
registerDateEnddate-timeNãoFiltra os membros pela data de cadastro final. (Formato: yyyy-mm-dd)
membershipStartDateStartdate-timeNãoFiltra os membros pela data de início da adesão à matrícula. (Formato: yyyy-mm-dd)
membershipStartDateEnddate-timeNãoFiltra os membros pela data de início da adesão à matrícula. (Formato: yyyy-mm-dd)
membershipCancelDateStartdate-timeNãoFiltra os membros pela data de cancelamento da adesão. (Formato: yyyy-mm-dd)
membershipCancelDateEnddate-timeNãoFiltra os membros pela data de cancelamento da adesão. (Formato: yyyy-mm-dd)
statusint32NãoFiltra os membros pelo status: 1 - Ativo (inclui Suspensos e Vips), 2 - Inativo
tokenGympassstringNãoFiltra pelo token do membro no Gympass.
takeint32NãoDefine o número total de registros a retornar. O valor padrão é 50. Máximo de 50.
skipint32NãoDefine o número de registros a serem pulados. O valor padrão é 0.
idsMembersstringNãoFiltra por IDs de membros. Adicione os IDs dos membros separados por vírgula (Ex.: 1,2,3)
onlyPersonalbooleanNãoDefine se deve mostrar apenas os treinadores pessoais. O valor padrão é false.
personalTypeint32NãoFiltra pelo tipo de personal trainer: 1 - Interno, 2 - Externo
showActivityDatabooleanNãoDefine se deve exibir dados de atividade dos membros. O valor padrão é false.
idBranchint32NãoFiltra pelo ID da filial do membro. (Disponível apenas ao usar uma chave multilocation)
updateDatedate-timeNãoFiltra membros com dados de atualização maiores ou iguais à data fornecida. (Formato: yyyy-mm-dd)
showMembershipsbooleanNãoDefine se deve exibir dados de matrícula dos membros. O valor padrão é false.
showsResponsiblesbooleanNãoDefine se deve mostrar os dados dos responsáveis pelo membro. O valor padrão é false.

Tipos de (status)

CódigoDescrição
1Membro Ativo (inclui suspensos e VIPs)
2Membro Inativo

Tipos de (personalType)

DescriçãoCódigo
Interno1
Externo2

Exemplo de Resposta

[
  {
    "idMember": 123,
    "firstName": "João",
    "lastName": "Silva",
    "registerDate": "2025-06-01T10:00:00Z",
    "status": "Active",
    "document": "12345678900",
    "email": "[email protected]",
    "phone": "11912341234",
    "birthDate": "1990-01-01T00:00:00Z",
    "address": "Rua Exemplo, 123",
    "city": "São Paulo",
    "state": "SP",
    "zipCode": "01234567",
    "memberships": [
      {
        "idMembership": 456,
        "name": "Plano Mensal",
        "startDate": "2025-06-01T00:00:00Z",
        "endDate": "2025-07-01T00:00:00Z",
        "membershipStatus": "Ativo"
      }
    ],
    "responsibles": [
      {
        "name": "Maria Silva",
        "cpf": "98765432100",
        "email": "[email protected]",
        "financialResponsible": true
      }
    ],
    "photoUrl": "https://cdn.academia.com/foto123.jpg"
  }
]

Language
Credentials
Basic
base64
:
Click Try It! to start a request and see the response here!