> ## 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.

# Consultar autorização

> Consulta a autorização registrada para um CPF ou CNPJ, com os dados do titular e da coleta do consentimento.

> [!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).

GET

/autorizacoes/autorizacao/:documento

```bash cURL theme={null}
curl -X GET https://api.databox360.com.br/api/autorizacoes/autorizacao/11222333000181 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
```

```javascript JavaScript theme={null}
const documento = "11222333000181";

const response = await fetch(
  `https://api.databox360.com.br/api/autorizacoes/autorizacao/${documento}`,
  {
    method: "GET",
    headers: {
      Authorization: "Bearer YOUR_JWT_TOKEN",
    },
  }
);

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

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

documento = "11222333000181"
url = f"https://api.databox360.com.br/api/autorizacoes/autorizacao/{documento}"
headers = {"Authorization": "Bearer YOUR_JWT_TOKEN"}

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

```php PHP theme={null}
<?php
$documento = '11222333000181';
$url = "https://api.databox360.com.br/api/autorizacoes/autorizacao/{$documento}";

$options = [
    'http' => [
        'header' => "Authorization: Bearer YOUR_JWT_TOKEN",
        'method' => 'GET'
    ]
];

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

```json Sucesso theme={null}
{
    "status": "sucesso",
    "dados": {
        "id": "3f2b8c1e-7a4d-4e5f-9b6a-1c2d3e4f5a6b",
        "nome": "EMPRESA EXEMPLO LTDA",
        "documento": "11222333000181",
        "tipoDocumento": "cnpj",
        "consentimento": true,
        "metadata": {
            "ip": "203.0.113.10",
            "host": "app.exemplo.com.br",
            "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36",
            "timestamp": "2026-01-15T13:00:05Z",
            "location": {
                "accuracy": 1000.0,
                "latitude": -23.5505,
                "longitude": -46.6333
            }
        },
        "dataExpiracao": "15/01/2031 10:00:05",
        "dataCriacao": "15/01/2026 10:00:05",
        "dataAtualizacao": "15/01/2026 10:00:05"
    },
    "data": "15/01/2026 10:05:00"
}
```

## Parâmetros de caminho

**documento** `string` *required*

CPF ou CNPJ do titular, apenas com dígitos. Ex: `11222333000181`.

## Resposta

**status** `string` *required*

Status da requisição. Valor esperado: `sucesso`.

**data** `string` *required*

Data e hora do processamento da requisição, no formato `DD/MM/YYYY HH:mm:ss`.

**dados** `object` *required*

Objeto com os dados da autorização.

**dados properties**

**dados.id** `string` *required*

Identificador único da autorização no formato UUID.

**dados.nome** `string` *required*

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

**dados.documento** `string` *required*

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

**dados.tipoDocumento** `string` *required*

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

**dados.consentimento** `boolean` *required*

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

**dados.dataExpiracao** `string` *required*

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

**dados.dataCriacao** `string` *required*

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

**dados.dataAtualizacao** `string` *required*

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

**dados.metadata** `object` *required*

Dados de contexto da coleta do consentimento, para rastreabilidade e auditoria.

**metadata properties**

**dados.metadata.ip** `string`

Endereço IP registrado no momento da coleta.

**dados.metadata.host** `string`

Host da aplicação que realizou a coleta.

**dados.metadata.userAgent** `string`

User agent registrado no momento da coleta.

**dados.metadata.timestamp** `string`

Data e hora da coleta no formato ISO 8601.

**dados.metadata.location** `object`

Dados de geolocalização registrados, quando informados.

**location properties**

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

Precisão da geolocalização em metros.

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

Latitude geográfica registrada.

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

Longitude geográfica registrada.


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