Skip to main content

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​

NomeTipoObrigatórioValores válidosDescrição
pagenumber❌inteiro, mínimo 1; padrão 1Página
searchstring❌até 100 caracteresNome 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
}