Skip to main content

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​

NomeTipoObrigatórioDescrição
limitnumber❌Itens por página
offsetnumber❌Offset de paginação
namestring❌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.

[]