Skip to main content

GET Listar Fornecedores

Retorna a lista de fornecedores com filtros opcionais.

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

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
limitnumberItens por página
offsetnumberOffset de paginação
namestringNome 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": "Laboratório Alpha",
"canGenerateLabel": true,
"accountId": 1,
"createdAt": "2025-03-07T13:30:34.210Z",
"updatedAt": "2026-05-18T22:35:10.215Z",
"deletedAt": null
},
{
"id": 2,
"name": "Clínica São Lucas",
"canGenerateLabel": false,
"accountId": 1,
"createdAt": "2025-03-07T13:30:34.212Z",
"updatedAt": "2025-03-07T13:30:34.212Z",
"deletedAt": null
},
{
"id": 3,
"name": "Centro Médico Vida",
"canGenerateLabel": false,
"accountId": 1,
"createdAt": "2025-08-04T13:31:33.762Z",
"updatedAt": "2025-08-11T10:07:17.052Z",
"deletedAt": null
}
]

200 Sucesso — sem resultados

Retornado quando nenhum fornecedor é encontrado para o name informado.

[]