GET Listar Possíveis Duplicados
Lista grupos de cadastros que parecem ser da mesma pessoa: mesmo CPF, ou mesmo nome e data de nascimento. Cada grupo traz os pacientes envolvidos. Paginado de 20 em 20 grupos, com os grupos por CPF primeiro.
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_patient_duplicates.
Endpoint
GET https://api-dev.imagemais.com.br/api/patients/duplicates
Parâmetros de Query
| Nome | Tipo | Obrigatório | Valores válidos | Descrição |
|---|---|---|---|---|
page | number | ❌ | inteiro, mínimo 1; padrão 1 | Página |
search | string | ❌ | até 100 caracteres | Nome ou CPF de algum cadastro do grupo |
Requisição
curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/patients/duplicates?page=1' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'
Respostas
200 Sucesso
{
"data": [
{
"reason": "cpf",
"patients": [
{
"id": 118,
"name": "Nome Exemplo",
"cpf": "12345678900",
"dateBirth": "1990-01-01T00:00:00.000Z",
"createdAt": "2025-03-10T12:00:00.000Z"
},
{
"id": 205,
"name": "Nome Exemplo",
"cpf": "12345678900",
"dateBirth": "1990-01-01T00:00:00.000Z",
"createdAt": "2026-11-02T12:00:00.000Z"
}
]
}
],
"total": 1,
"totals": {
"cpf": 1,
"nameBirth": 0
},
"page": 1,
"pageSize": 20
}
reason é cpf ou name_birth. Grupos por nome e nascimento só aparecem quando não são um subconjunto de um grupo por CPF. CPFs com todos os dígitos iguais são ignorados. total é o número de grupos que casam com search; totals separa por motivo.
400 Requisição inválida
Retornado quando o corpo ou a query não passam na validação. A lista message traz um item por regra violada, por exemplo:
{
"message": [
"page must not be less than 1"
],
"error": "Bad Request",
"statusCode": 400
}
403 Sem permissão
{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}