FornecedoresConsultar Fornecedor por ID

Consultar Fornecedor por ID

Retorna os dados de um fornecedor específico da empresa pelo ID numérico.

Regras:

curl -X GET "https://api-sandbox.contasimples.com/suppliers/v1/suppliers/16" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "id": 16,
  "name": "Fornecedor Fictício LTDA",
  "type": {
    "id": 1,
    "type": "CUSTOM"
  }
}
GET
/suppliers/v1/suppliers/{id}
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer {token}

Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer {token}
path
idinteger
Required

Identificador numérico do fornecedor — use o valor do campo id retornado em GET /suppliers/v1/suppliers.

Format: int32
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer {token}

Path Parameters

idinteger
Required

Identificador numérico do fornecedor — use o valor do campo id retornado em GET /suppliers/v1/suppliers.

Responses

idinteger
Required

Identificador numérico do fornecedor.

companyIdstring

Sempre retorna o ID da empresa autenticada.

namestring
Required

Nome do fornecedor.

typestring
Required

Tipo do fornecedor. Indica se foi criado pela empresa (CUSTOM) ou é pré-cadastrado pela plataforma (DEFAULT).