GET Estado Atual do Orçamento
Devolve o mesmo formato do data dos eventos budget.*. Serve para reconciliar: como a entrega de webhooks não é ordenada, o consumidor pode reconsultar o estado atual do recurso e comparar o version.
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 manage_webhooks.
Endpoint
GET https://api-dev.imagemais.com.br/api/webhooks/resources/budgets/{id}
Parâmetros de Rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | ✅ | ID do orçamento |
Requisição
curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/webhooks/resources/budgets/1' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'
Respostas
200 Sucesso
{
"object": "budget",
"id": 5501,
"version": 1759771930123,
"status": "SENT",
"patient": {
"id": 1234,
"name": "Nome Exemplo",
"cpf": "12345678900",
"birth_date": "1990-01-01",
"gender": "F",
"phone": "+5511999999999"
},
"requesting_doctor": {
"id": 7,
"name": "Nome Exemplo",
"council": "CRM",
"council_number": "123456",
"council_uf": "SP"
},
"items": [
{
"procedure": {
"id": 10,
"name": "Ultrassonografia obstétrica",
"type": "IMAGEM",
"modality": "US",
"local_report": false,
"codes": [
{
"system": "SUPPLIER",
"supplier_id": 2,
"value": "USOB01"
}
]
},
"price": "150.00"
}
],
"gross_value": "150.00",
"discount_value": "0.00",
"net_value": "150.00",
"paid_value": "150.00",
"pending_value": "0.00",
"currency": "BRL",
"released": true,
"appointment_id": 98765,
"created_at": "2026-10-05T12:00:00-03:00",
"updated_at": "2026-10-06T14:32:10-03:00"
}
Valores de status: PENDING, SENT, FAILED. Os valores monetários são string decimal com 2 casas. released é true quando o total pago somado ao pendente cobre o valor líquido. net_value = gross_value − discount_value, considerando descontos por item e o desconto geral ativo.
400 Requisição inválida
Retornado quando o id não é numérico.
{
"message": "Validation failed (numeric string is expected)",
"error": "Bad Request",
"statusCode": 400
}
403 Sem permissão
{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}
404 Não encontrado
{
"message": "Orçamento não encontrado",
"error": "Not Found",
"statusCode": 404
}