Enviar autorização

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"
        }
      }'

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);

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
$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);
?>

{
    "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"
}

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"
        }
      }'

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);

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
$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);
?>

{
    "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"
}

Esta rota requer autenticação via Bearer Token. Certifique-se de ter sua API Key e token JWT configurados conforme descrito em Autenticação.

POST

/autorizacoes

Se já existir uma autorização para o documento informado, o registro é atualizado e não duplicado. Veja Conceitos.

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"
        }
      }'

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);

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
$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);
?>

{
    "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

string

required

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

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.

string

required

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

boolean

required

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

object

required

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

Show metadata properties

string

required

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

string

required

Host da aplicação que realizou a coleta.

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.

string

required

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

object

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

Show location properties

number

Precisão da geolocalização em metros.

number

Latitude geográfica do dispositivo.

number

Longitude geográfica do dispositivo.

Resposta

boolean

required

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

string

required

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

object

required

Objeto com os dados da autorização registrada.

Show data properties

string

required

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

string

required

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

string

required

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

string

required

Tipo do documento: cpf ou cnpj.

boolean

required

Confirma o consentimento registrado. Valor esperado: true.

string

required

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

string

required

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

string

required

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

string

required

Endereço IP registrado no momento da coleta.

Esta resposta não devolve o metadata completo. Para ver todos os dados da coleta, use Consultar autorização.

Databox360 API

Autenticação API

SCR Bacen

Autorizador SCR

Perfil Financeiro

Requisição

Resposta

​Requisição

​Resposta

Requisição

Resposta