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
| 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 do cadastro que ficou ou do que saiu |
scope | string | ❌ | undoable (padrão) ou all | undoable: 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
}