Skip to main content

GET Listar Junções

Lista as junções de cadastros da clínica, da mais recente para a mais antiga. Por padrão traz só as que ainda dá para desfazer (últimos 30 dias e não desfeitas). Paginado de 20 em 20.

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/merges

Parâmetros de Query​

NomeTipoObrigatórioValores válidosDescrição
pagenumber❌inteiro, mínimo 1; padrão 1Página
searchstring❌até 100 caracteresNome ou CPF do cadastro que ficou ou do que saiu
scopestring❌undoable (padrão) ou allundoable: só as que ainda dá para desfazer; all: todas, inclusive as desfeitas e as fora do prazo

Requisição​

curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/patients/merges?scope=all&page=1' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'

Respostas​

200 Sucesso​

{
"data": [
{
"id": 12,
"sourcePatientId": 205,
"targetPatientId": 118,
"sourceName": "Nome Exemplo",
"userName": "Nome Exemplo",
"reason": "Cadastro duplicado na recepção",
"status": "DONE",
"createdAt": "2026-11-10T14:00:00.000Z",
"moved": {
"appointments": 3,
"consultations": 2,
"budgets": 1
},
"undoUntil": "2026-12-10T14:00:00.000Z",
"canUndo": true,
"targetName": "Nome Exemplo",
"revertedAt": null
}
],
"total": 1,
"page": 1,
"pageSize": 20
}

status: FILES_PENDING (junção feita, cópia das declarações ainda em andamento), DONE ou REVERTED (desfeita). canUndo é false se a junção já foi desfeita ou passou o prazo de 30 dias (undoUntil).

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": [
"scope must be one of the following values: undoable, all"
],
"error": "Bad Request",
"statusCode": 400
}

403 Sem permissão​

{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}