GET Listar Pacientes
Lista todos os pacientes da Empresa (Account)
Autenticação necessária
Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
Permissão necessária
Exige a permissão read_patients.
Endpoint
GET https://api-dev.imagemais.com.br/api/patients
Parâmetros de Query
| Nome | Tipo | Obrigatório | Valores válidos | Descrição |
|---|---|---|---|---|
limit | number | ❌ | inteiro; mín. 0; máx. 100 | Número de itens retornados a cada página |
offset | number | ❌ | inteiro; mín. 0 | Número da página atual |
name | string | ❌ | — | Nome do paciente para busca |
cpf | string | ❌ | — | CPF do paciente para busca |
rg | string | ❌ | — | RG do paciente para busca |
deleted | boolean | ❌ | — | Usar true para retornar pacientes deletados |
phone | string | ❌ | — | Telefone do paciente |
filter | string | ❌ | incomplete ou new | Recorte dos cards da lista. incomplete: cadastros sem CPF, nascimento, gênero ou telefone; new: criados no mês corrente |
cursor | number | ❌ | inteiro positivo | Id do último paciente carregado (paginação por cursor) |
Requisição
curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/patients' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'
Respostas
200 Sucesso
[
{
"id": 60,
"name": "Nome Exemplo",
"gender": {
"name": "M"
},
"dateBirth": "1990-01-01T00:00:00.000Z",
"rg": null,
"cpf": null,
"address": {
"street": null,
"number": null,
"district": null,
"city": null,
"state": null,
"cep": "50000000",
"complement": null
},
"contact": {
"phone": "(81) 99999-9999",
"email": null,
"secondary_phone": null
},
"createdAt": "2026-08-31T13:03:49.725Z",
"updatedAt": "2026-08-31T13:03:49.725Z",
"deletedAt": null
}
]
403 Sem permissão
{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}