---
title: 3.1. Bureaus Habilitados
url: https://docs.vehub.com.br/Emiss%C3%A3o%20de%20Ativos/API/Bureau/3.%20Consulta%20SCR/3.1.%20Bureaus%20Habilitados/
---
# 3.1. Bureaus Habilitados

## Endpoint

| Método | URL |
|--------|-----|
| ![GET](https://img.shields.io/badge/GET-green) | `/bureaus/habilitados` |

---

## Descrição

Lista os bureaus habilitados para o grupo econômico informado no header `GrupoEconomico`. É o
**primeiro passo** da integração: confirma que a credencial está vinculada ao grupo e que o SCR está
liberado antes de você solicitar a primeira consulta.

Esta rota não gera custo e pode ser chamada a qualquer momento — por exemplo, na inicialização do
seu sistema ou antes de exibir a opção de consulta ao usuário.

### Headers

Apenas os headers padrão (`Authorization` e `GrupoEconomico`). Ver
[1.1.2 Autenticação](../1.%20Início/1.1.%20Primeiros%20Passos.md#112-autenticacao).

---

## Exemplo de cURL

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

---

## Responses

### 200 OK — SCR habilitado

```json
[
  { "id": 1, "nome": "SCR" }
]
```

| Campo | Tipo | Descrição |
|-------|------|-----------|
| id | integer | Identificador do bureau. Ver [2.1. Enumerações](../2.%20Enumerações/2.1.%20Enumerações.md) |
| nome | string | Nome do bureau |

### 200 OK — nenhum bureau habilitado

O grupo não tem nenhum bureau liberado. Não é erro: a lista vem vazia.

```json
[]
```

### 401 Unauthorized

Token ausente, expirado ou inválido, ou header `GrupoEconomico` ausente:

```json
{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.2",
  "status": 401,
  "errors": [
    { "campo": null, "mensagem": "Header GrupoEconomico não informado. Por favor, forneça um Grupo Econômico válido." }
  ]
}
```

### 403 Forbidden

A credencial não está vinculada ao grupo econômico informado:

```json
{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.4",
  "status": 403,
  "errors": [
    { "campo": null, "mensagem": "A credencial seu-client-id não está habilitada para o grupo econômico MeuGrupo." }
  ]
}
```

---

## Próximo passo

Com o SCR na lista, colete o aceite do titular e solicite a consulta em
[3.2. Solicitar Consulta](3.2.%20Solicitar%20Consulta.md).

---

## Observações

- **Lista vazia não é erro.** Se o SCR não aparece, a habilitação do grupo ainda não foi feita (ou
  foi retirada). Nesse caso, as rotas `/bureaus/scr` respondem `403`. Fale com o nosso time.
- **`403` nesta rota é problema de credencial**, não de habilitação do bureau: confira o `clientId`
  e o nome do grupo enviado em `GrupoEconomico`.
- A habilitação vale para **todas** as credenciais vinculadas ao grupo.