Ir para o conteúdo

3.1. Financiadores

🔗 Endpoint

Método URL
GET /public/v1/financiadores

🧾 Descrição

Retorna a lista de financiadores disponíveis para utilização na criação de uma Nota Comercial.

  • Caso a chave de acesso pertença a um parceiro, apenas os financiadores vinculados ao parceiro serão retornados.
  • Caso a chave pertença a um estruturador, todos os financiadores disponíveis serão retornados.

Não é possível cadastrar novos financiadores via API.


🧪 Exemplo de cURL

curl -X GET https://api.vehub.com.br/public/v1/financiadores \
  -H "Authorization: Bearer {seu_token}" \
  -H "GrupoEconomico: {seu_grupo_economico}"

📥 Responses

✅ 200 OK

[
  {
    "id": 1,
    "nome": "Financiadora Alpha S.A.",
    "documento": "12345678000199"
  },
  {
    "id": 2,
    "nome": "Fundo Beta de Investimentos",
    "documento": "98765432000155"
  }
]

Detalhamento dos Campos

Campo Tipo Descrição
id integer Identificador único do financiador
nome string Razão social do financiador
documento string CNPJ do financiador (somente números)

❌ 401 Unauthorized

{
  "tipo": "https://tools.ietf.org/html/rfc9110#section-15.6.2",
  "titulo": "Não autorizado",
  "status": 401,
  "erros": ["Token de autenticação inválido ou expirado."]
}