GET Listar Pedidos do Laboratório

Retorna todos os pedidos de exames do laboratório com filtros por período, status e busca.

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

Campos obrigatórios

Os parâmetros from e to são obrigatórios para esta requisição.

---

Endpoint

GET https://api-dev.imagemais.com.br/api/laboratories/orders

---

Parâmetros de Query

Nome	Tipo	Obrigatório	Valores válidos	Descrição
from	string	✅	YYYY-MM-DD	Data inicial do período
to	string	✅	YYYY-MM-DD	Data final do período
limit	number	❌	0–100	Itens por página (padrão: 12)
search	string	❌	qualquer	Busca por nome ou CPF do paciente
status	string	❌	RELEASE, ANALYZING, CANCELED	Status do resultado da integração
statusReview	string	❌	ANALYZING, SENT	Status de revisão do resultado
cursor	string	❌	ID numérico do último id retornado	Cursor para buscar a próxima página

status ou statusReview

Pelo menos um dos parâmetros status ou statusReview é obrigatório — sem eles a rota retorna 400 Bad Request.

Paginação

A paginação é feita por cursor, não por offset: use o valor de pagination.nextCursor retornado na resposta como o parâmetro cursor da próxima requisição. Quando nextCursor é null, não há mais páginas.

Valores de status

Valor	Descrição
RELEASE	Liberado
ANALYZING	Em análise
CANCELED	Cancelado

Valores de statusReview

Valor	Descrição
ANALYZING	Em análise
SENT	Enviado

---

Requisição

curl -X 'GET' \
  'https://api-dev.imagemais.com.br/api/laboratories/orders?limit=50&from=2026-01-01&to=2026-02-19&statusReview=SENT' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {accessToken}'

---

Respostas

200 Sucesso

{
  "data": [
    {
      "id": 6854,
      "ulid": "01KHBBSJCXQBD0QBHGTF1GZQCQ",
      "patientExams": {
        "uuid": "<examUuid>",
        "prefix": "IMGM",
        "patient": {
          "name": "NOME DO PACIENTE",
          "dateBirth": "1990-01-01T00:00:00.000Z",
          "gender": {
            "id": 1,
            "name": "F"
          },
          "cpf": "00000000000",
          "contact": {
            "phone": "00000000000"
          }
        },
        "procedureSupplier": [
          {
            "procedure": {
              "name": "CREATININA"
            }
          },
          {
            "procedure": {
              "name": "GLICOSE JEJUM"
            }
          }
        ]
      },
      "resultsIntegration": {
        "uuid": "<integrationUuid>",
        "status": {
          "name": "RELEASE"
        },
        "statusReview": {
          "name": "SENT"
        },
        "updatedAt": "2026-02-19T12:06:57.919Z"
      },
      "reports": []
    }
  ],
  "pagination": {
    "nextCursor": 6854
  }
}

200 Com laudos (reports)

Quando os pedidos possuem laudos gerados, o campo reports é preenchido com os dados de cada laudo.

{
  "data": [
    {
      "id": 6854,
      "ulid": "01KHBBSJCXQBD0QBHGTF1GZQCQ",
      "patientExams": {
        "uuid": "<examUuid>",
        "prefix": "IMGM",
        "patient": {
          "name": "MARIA OLIVEIRA SANTOS",
          "dateBirth": "1990-03-15T00:00:00.000Z",
          "gender": {
            "id": 1,
            "name": "F"
          },
          "cpf": "00000000000",
          "contact": {
            "phone": "00000000000"
          }
        },
        "procedureSupplier": [
          {
            "procedure": {
              "name": "CREATININA"
            }
          },
          {
            "procedure": {
              "name": "GLICOSE JEJUM"
            }
          }
        ]
      },
      "resultsIntegration": {
        "uuid": "<integrationUuid>",
        "status": {
          "name": "RELEASE"
        },
        "statusReview": {
          "name": "SENT"
        },
        "updatedAt": "2026-05-16T10:38:27.517Z"
      },
      "reports": [
        {
          "procedure": {
            "id": 1028,
            "name": "CREATININA"
          },
          "status": {
            "name": "SIGNED"
          }
        },
        {
          "procedure": {
            "id": 1702,
            "name": "GLICOSE JEJUM"
          },
          "status": {
            "name": "DRAFT"
          }
        }
      ]
    }
  ],
  "pagination": {
    "nextCursor": 6854
  }
}

200 Sem resultados

Retornado quando não há pedidos no período informado.

{
  "data": [],
  "pagination": {
    "nextCursor": null
  }
}