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

# Quick Start — primeiro resultado em minutos

> Faça sua primeira consulta de bureau e receba o resultado via webhook

## Pré-requisito: você precisa de

* Uma **API key** `sk_test_...` (sandbox)
* Um **template ativo** no seu tenant
* Uma **URL de webhook** para receber o resultado

***

## Passo 1 — Obter sua API key

1. Acesse **Integrações & API → API Keys** no [dashboard kycert](https://admin.kycert.com.br)
2. Clique em **Nova chave**
3. Selecione o escopo `runs:write`
4. Copie a chave (`sk_test_...`) imediatamente — ela não é exibida novamente

***

## Passo 2 — Obter o template\_id

No [dashboard kycert](https://admin.kycert.com.br), acesse **Bureau KYC → Templates**. Copie o ID do template ativo que você quer usar — você vai precisar dele no próximo passo.

<Note>
  Crie um template no dashboard antes de prosseguir — não há template pré-configurado na sua conta.
</Note>

***

## Passo 3 — Configurar o endpoint de webhook

Abra [webhook.site](https://webhook.site) e copie a URL gerada. Você vai usá-la como `webhook_url` no próximo passo para receber o resultado.

Em produção, use um endpoint HTTPS próprio e valide a assinatura HMAC-SHA256. Veja [Segurança de Webhooks](/webhooks/seguranca).

***

## Passo 4 — Criar o primeiro run

Use o CPF `00000000191` com a chave e o template do sandbox. Este CPF sempre retorna resultado aprovado.

```bash theme={null}
curl -X POST https://admin.kycert.com.br/api/v1/bureau/runs \
  -H "x-api-key: sk_test_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "SEU_TEMPLATE_ID",
    "subject": {
      "type": "pf",
      "doc":  "00000000191"
    },
    "webhook_url": "https://webhook.site/SEU_ID"
  }'
```

Resposta imediata (`202`):

```json theme={null}
{
  "run_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "livemode": false
}
```

***

## Passo 5 — Receber o resultado via webhook

Em 5–60 segundos (varia por template), o resultado chega no webhook.site:

```json theme={null}
{
  "id": "evt_abc123",
  "event": "run.completed",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "completed",
    "decision": "approved",
    "risk_band": "baixo",
    "subject_type": "pf"
  }
}
```

***

## Passo 6 — Próximos passos

* [Autenticação](/autenticacao) — escopos, versionamento e boas práticas de segurança
* [Guia de webhook](/guias/integracao-webhook) — validação de assinatura, retry e idempotência
* [Sandbox](/sandbox) — todos os CPFs e CNPJs de cenário disponíveis