Skip to main content

GET Buscar Fornecedor por ID

Retorna os dados de um fornecedor pelo seu ID.

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_suppliers.

ID do fornecedor

O id pode ser obtido na rota de Listar Fornecedores, no campo id de cada fornecedor.


Endpoint​

GET https://api-dev.imagemais.com.br/api/suppliers/{id}

Path Parameter​

CampoTipoObrigatórioDescrição
idnumber✅ID do fornecedor

Requisição​

curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/suppliers/1' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'

Respostas​

200 Sucesso​

{
"id": 1,
"name": "Diagnóstico Brasil",
"accountId": 1,
"createdAt": "2026-07-23T00:49:22.406Z",
"updatedAt": "2026-07-30T11:20:36.687Z",
"deletedAt": null,
"canGenerateLabel": true,
"guideUrl": "https://gde.diagnosticosdobrasil.com.br/exam/{code}",
"isSystem": true
}

404 Fornecedor não encontrado​

Retornado quando o id informado não existe.

{
"statusCode": 404,
"message": "Supplier não encontrado"
}