GET Listar Consultas

Retorna a lista de consultas com filtros opcionais.

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

Nenhum campo é obrigatório

Todos os parâmetros são opcionais. A requisição funciona sem nenhum filtro.

---

Endpoint

GET https://api-dev.imagemais.com.br/api/consultations

---

Parâmetros de Query

Nome	Tipo	Obrigatório	Valores válidos	Descrição
limit	number	❌	0–100	Itens por página (padrão: 5)
offset	number	❌	>= 0	Página atual (offset de paginação)
name	string	❌	qualquer	Nome do paciente para busca
cpf	string	❌	qualquer	CPF do paciente
patientId	string	❌	qualquer	ID do paciente
deleted	string (boolean)	❌	"true", "false"	Aceito pela validação, mas sem efeito — não é usado na consulta ao banco (parâmetro morto no código atual)
consultationType	string (enum)	❌	"ONLINE", "PRESENCIAL"	Tipo da consulta
status	string (enum)	❌	"OPENED", "FINAL", "CLOSED"	Status da consulta. OPENED retorna também FINAL
urgencyLevel	string	❌	qualquer	Nível de urgência (Protocolo de Manchester)

---

Requisição

curl -X 'GET' \
  'https://api-dev.imagemais.com.br/api/consultations?limit=5&consultationType=ONLINE' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {accessToken}'

---

Respostas

200 Sucesso

Envelope de resposta

A resposta é um objeto { data, total }, não um array puro. total é a contagem total de registros que combinam com o filtro (independente de limit/offset), útil para paginação.

{
  "data": [
    {
      "id": 324,
      "patientId": 17529,
      "preConsultationId": 324,
      "urgencyLevel": null,
      "mainComplaint": null,
      "allergies": null,
      "cardiovascularDiseases": null,
      "otherRelevantDiseases": null,
      "previousSurgeries": null,
      "familyHistory": null,
      "medicationsUse": null,
      "lifestyleHabits": null,
      "lifestyleAdvice": null,
      "followUpExams": null,
      "referralsToSpecialists": null,
      "medicalCertificate": null,
      "declaration": null,
      "currentDiseaseHistory": null,
      "prescribedMedications": null,
      "medicalConduct": null,
      "personalHistory": null,
      "physicalExam": null,
      "primaryAndSecondaryDiagnosis": null,
      "diagnosisReasoning": null,
      "iaConclusion": null,
      "createdAt": "2026-05-06T18:44:06.027Z",
      "updatedAt": "2026-05-06T18:54:15.432Z",
      "deletedAt": null,
      "preConsultation": {
        "id": 324,
        "bloodPressure": "",
        "heartRate": "",
        "temperature": "",
        "weight": "",
        "height": "",
        "consultationReason": "",
        "glucose": "",
        "updatedAt": "2026-05-06T18:44:05.943Z"
      },
      "consultationType": {
        "name": "ONLINE"
      },
      "consultationStatus": {
        "name": "FINAL"
      },
      "consultationFiles": [
        {
          "id": 311,
          "url": "https://storagedev.imagemaislaboratorio.com.br/telemedicine/...",
          "fileType": "telemedicine-recording",
          "name": "Gravação telemedicina - 06/05/2026 15:55:01",
          "accountId": null,
          "createdAt": "2026-05-06T18:55:01.078Z",
          "updatedAt": "2026-05-06T18:55:01.078Z",
          "deletedAt": null
        }
      ],
      "cardiologicalOpinion": null,
      "specialControlPrescriptionPdf": null,
      "memedPrescriptions": [],
      "patient": {
        "id": 17529,
        "name": "LUCAS THIAGO COSTA BARRETO DE LIMA",
        "cpf": "09974236402",
        "dateBirth": "1999-11-23T00:00:00.000Z",
        "gender": {
          "name": "F"
        },
        "contact": {
          "phone": "(81) 99743-8893",
          "email": null
        }
      },
      "finalizedByUser": {
        "id": 1,
        "name": "Ana Ferreira Souza"
      }
    }
  ],
  "total": 15
}

200 Sucesso — sem resultados

Retornado quando nenhuma consulta é encontrada para os filtros informados (patientId, cpf ou name inexistentes).

{
  "data": [],
  "total": 0
}