Skip to main content

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

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

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​

NomeTipoObrigatórioValores válidosDescrição
fromstring✅YYYY-MM-DDData inicial do período
tostring✅YYYY-MM-DDData final do período
limitnumber❌0–100Itens por página (padrão: 12)
searchstring❌qualquerBusca por nome ou CPF do paciente
statusstring❌RELEASE, ANALYZING, CANCELEDStatus do resultado da integração
statusReviewstring❌ANALYZING, SENTStatus de revisão do resultado
cursorstring❌ID numérico do último id retornadoCursor para buscar a próxima página
offsetnumber❌inteiro; mín. 0Número da página atual
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​

ValorDescrição
RELEASELiberado
ANALYZINGEm análise
CANCELEDCancelado

Valores de statusReview​

ValorDescrição
ANALYZINGEm análise
SENTEnviado

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
}
}

400 Bad Request​

Retornado quando nem status nem statusReview são enviados:

{
"message": "status ou statusReview são obrigatórios",
"error": "Bad Request",
"statusCode": 400
}

Retornado quando from ou to não são enviados:

{
"message": [
"from must be a string",
"to must be a string"
],
"error": "Bad Request",
"statusCode": 400
}