---
title: 3.1. Financiadores
url: https://docs.vehub.com.br/API/Nota%20Comercial/3.%20Refer%C3%AAncias/3.1.%20Financiadores/
---
# 3.1. Financiadores

## 🔗 Endpoint

| Método | URL |
|--------|-----|
| ![GET](https://img.shields.io/badge/GET-green) | `/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

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

---

## 📥 Responses

### ✅ 200 OK

```json
[
  {
    "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

```json
{
  "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."]
}
```