GET Listar Fornecedores
Retorna a lista de fornecedores com filtros opcionais.
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.
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/suppliers
Parâmetros de Query
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
limit | number | ❌ | Itens por página |
offset | number | ❌ | Offset de paginação |
name | string | ❌ | Nome do fornecedor para busca |
Requisição
curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/suppliers?limit=50&offset=0' \
-H 'accept: */*' \
-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
}
]
200 Sucesso — sem resultados
Retornado quando nenhum fornecedor é encontrado para o name informado.
[]