> ## Documentation Index
> Fetch the complete documentation index at: https://docs.databox360.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar autorização

> Registra o consentimento do titular para consulta ao SCR Bacen, coletando dados de identificação e metadata da solicitação.

> [!NOTE]
>
> Esta rota requer autenticação via Bearer Token. Certifique-se de ter sua API Key e token JWT configurados conforme descrito em [Autenticação](https://docs.databox360.com.br/api-reference/autenticacao.md).

POST

/autorizacoes

Se já existir uma autorização para o documento informado, o registro é atualizado e não duplicado. Veja [Conceitos](https://docs.databox360.com.br/autorizador/conceitos#reenvio-atualiza-o-registro).

```bash cURL theme={null}
curl -X POST https://api.databox360.com.br/api/autorizacoes \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "nome": "EMPRESA EXEMPLO LTDA",
        "documento": "11.222.333/0001-81",
        "tipoDocumento": "cnpj",
        "consentimento": true,
        "metadata": {
          "ip": "203.0.113.10",
          "host": "app.exemplo.com.br",
          "location": {
            "accuracy": 1000.0,
            "latitude": -23.5505,
            "longitude": -46.6333
          },
          "timestamp": "2026-01-15T10:00:00-03:00",
          "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36"
        }
      }'
```

```javascript JavaScript theme={null}
const response = await fetch("https://api.databox360.com.br/api/autorizacoes", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_JWT_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    nome: "EMPRESA EXEMPLO LTDA",
    documento: "11.222.333/0001-81",
    tipoDocumento: "cnpj",
    consentimento: true,
    metadata: {
      ip: "203.0.113.10",
      host: "app.exemplo.com.br",
      location: {
        accuracy: 1000.0,
        latitude: -23.5505,
        longitude: -46.6333,
      },
      timestamp: "2026-01-15T10:00:00-03:00",
      userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36",
    },
  }),
});

const data = await response.json();
console.log(data);
```

```python Python theme={null}
import requests

url = "https://api.databox360.com.br/api/autorizacoes"
headers = {
    "Authorization": "Bearer YOUR_JWT_TOKEN",
    "Content-Type": "application/json"
}
payload = {
    "nome": "EMPRESA EXEMPLO LTDA",
    "documento": "11.222.333/0001-81",
    "tipoDocumento": "cnpj",
    "consentimento": True,
    "metadata": {
        "ip": "203.0.113.10",
        "host": "app.exemplo.com.br",
        "location": {
            "accuracy": 1000.0,
            "latitude": -23.5505,
            "longitude": -46.6333
        },
        "timestamp": "2026-01-15T10:00:00-03:00",
        "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36"
    }
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()
```

```php PHP theme={null}
<?php
$url = 'https://api.databox360.com.br/api/autorizacoes';
$data = [
    'nome' => 'EMPRESA EXEMPLO LTDA',
    'documento' => '11.222.333/0001-81',
    'tipoDocumento' => 'cnpj',
    'consentimento' => true,
    'metadata' => [
        'ip' => '203.0.113.10',
        'host' => 'app.exemplo.com.br',
        'location' => [
            'accuracy' => 1000.0,
            'latitude' => -23.5505,
            'longitude' => -46.6333
        ],
        'timestamp' => '2026-01-15T10:00:00-03:00',
        'userAgent' => 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36'
    ]
];

$options = [
    'http' => [
        'header' => [
            "Authorization: Bearer YOUR_JWT_TOKEN",
            "Content-type: application/json"
        ],
        'method' => 'POST',
        'content' => json_encode($data)
    ]
];

$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
$data = json_decode($result, true);
?>
```

```json Sucesso theme={null}
{
    "sucesso": true,
    "data": {
        "id": "3f2b8c1e-7a4d-4e5f-9b6a-1c2d3e4f5a6b",
        "nome": "EMPRESA EXEMPLO LTDA",
        "documento": "11222333000181",
        "tipoDocumento": "cnpj",
        "consentimento": true,
        "dataExpiracao": "15/01/2031 10:00:05",
        "dataCriacao": "15/01/2026 10:00:05",
        "dataAtualizacao": "15/01/2026 10:00:05",
        "ip": "203.0.113.10"
    },
    "message": "Consentimento registrado com sucesso"
}
```

## Requisição

**nome** `string` *required*

Nome completo da pessoa física ou razão social da pessoa jurídica titular do consentimento.

**documento** `string` *required*

Número do documento do titular: `CPF` (pessoa física) ou `CNPJ` (pessoa jurídica). Pode ser enviado com ou sem pontuação; a resposta devolve apenas os dígitos.

**tipoDocumento** `string` *required*

Tipo do documento informado. Valores aceitos: `cpf` ou `cnpj`. Informe o tipo que corresponde ao número enviado.

**consentimento** `boolean` *required*

Indica se o titular concedeu o consentimento expresso para consulta ao SCR. Deve ser `true` para registrar a autorização.

**metadata** `object` *required*

Objeto com dados de contexto da coleta do consentimento, utilizados para rastreabilidade e auditoria.

**metadata properties**

**metadata.ip** `string` *required*

Endereço IP (IPv4 ou IPv6) do dispositivo do titular no momento da coleta do consentimento.

**metadata.host** `string` *required*

Host da aplicação que realizou a coleta.

**metadata.timestamp** `string` *required*

Data e hora da coleta do consentimento no formato ISO 8601, com fuso horário. Ex: `2026-01-15T10:00:00-03:00`.

**metadata.userAgent** `string` *required*

User agent do navegador ou aplicação utilizada pelo titular no momento do consentimento.

**metadata.location** `object`

Dados de geolocalização do dispositivo no momento da coleta (quando disponível).

**location properties**

**metadata.location.accuracy** `number`

Precisão da geolocalização em metros.

**metadata.location.latitude** `number`

Latitude geográfica do dispositivo.

**metadata.location.longitude** `number`

Longitude geográfica do dispositivo.

## Resposta

**sucesso** `boolean` *required*

Indica se a requisição foi processada com sucesso. Valor esperado: `true`.

**message** `string` *required*

Mensagem descritiva do resultado. Ex: `Consentimento registrado com sucesso`.

**data** `object` *required*

Objeto com os dados da autorização registrada.

**data properties**

**data.id** `string` *required*

Identificador único da autorização, gerado pela plataforma no formato UUID.

**data.nome** `string` *required*

Nome completo ou razão social do titular do consentimento.

**data.documento** `string` *required*

Número do documento do titular sem formatação (apenas dígitos).

**data.tipoDocumento** `string` *required*

Tipo do documento: `cpf` ou `cnpj`.

**data.consentimento** `boolean` *required*

Confirma o consentimento registrado. Valor esperado: `true`.

**data.dataExpiracao** `string` *required*

Data e hora de expiração da autorização, no formato `DD/MM/YYYY HH:mm:ss`.

**data.dataCriacao** `string` *required*

Data e hora de criação da autorização, no formato `DD/MM/YYYY HH:mm:ss`.

**data.dataAtualizacao** `string` *required*

Data e hora da última atualização da autorização, no formato `DD/MM/YYYY HH:mm:ss`.

**data.ip** `string` *required*

Endereço IP registrado no momento da coleta.

> [!NOTE]
>
> Esta resposta não devolve o `metadata` completo. Para ver todos os dados da coleta, use [Consultar autorização](https://docs.databox360.com.br/autorizador/consultar-autorizacao).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.