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

# Reporte SOAT de la SBS

> Consulte o histórico de sinistralidade SOAT e as apólices de uma placa na SBS.

Reporta o registro SOAT (Seguro Obligatorio de Accidentes de Tránsito) de uma
placa veicular na SBS (Superintendencia de Banca, Seguros y AFP), o
regulador peruano de bancos e seguros. Retorna a sinistralidade (número de
acidentes cobertos por apólices SOAT nos últimos 5 anos) e a lista de
apólices SOAT registradas: companhia seguradora, classe e uso do veículo,
acidentes por apólice, vigência e estado. Uma consulta, por placa.

## Reporte SOAT

`POST /pe/sbs/soat/v1`

| Campo   | Tipo   | Notas                                                                                          |
| ------- | ------ | ---------------------------------------------------------------------------------------------- |
| `plate` | string | **Obrigatório.** A placa veicular a consultar, de 4 a 10 caracteres (letras, dígitos, hífens). |

```bash theme={"dark"}
curl https://api.croma.run/pe/sbs/soat/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "plate": "ABC123" }'
```

## Resposta

| Campo             | Notas                                                                                        |
| ----------------- | -------------------------------------------------------------------------------------------- |
| `found`           | `true` quando a fonte reporta informações SOAT para a placa.                                 |
| `plate`           | A placa consultada (sem espaços, em maiúsculas).                                             |
| `report_date`     | Momento em que a fonte gerou o relatório (ISO, quando interpretável).                        |
| `data_through`    | O rótulo de atualização de dados da fonte (por exemplo `ABRIL 2026`).                        |
| `accident_count`  | Acidentes cobertos pelo SOAT nos últimos 5 anos (sinistralidade).                            |
| `has_active_soat` | `true` quando há uma apólice vigente (VIGENTE).                                              |
| `active`          | A apólice vigente (VIGENTE), ou `null` quando nenhuma está ativa.                            |
| `count`           | Número de apólices registradas.                                                              |
| `policies[]`      | Histórico de apólices, da mais recente à mais antiga. Vazio quando a placa não tem registro. |

Cada apólice (`active` e cada entrada de `policies[]`) tem `company`,
`vehicle_class`, `vehicle_use`, `accident_count`, `policy_number`,
`certificate_number`, `start_date` e `end_date` (`yyyy-mm-dd` quando
interpretável), `status` (`VIGENTE` / `VENCIDA` / `ANULADA`), `annulled_date` e
`comment`.

```json theme={"dark"}
{
  "data": {
    "found": true,
    "plate": "ABC123",
    "report_date": "2026-06-23T20:03:23",
    "data_through": "ABRIL 2026",
    "accident_count": 0,
    "has_active_soat": true,
    "active": {
      "company": "Interseguro",
      "vehicle_class": "Automóvil",
      "vehicle_use": "Particular",
      "accident_count": 0,
      "policy_number": "0594770702",
      "certificate_number": "0594770702",
      "start_date": "2026-02-19",
      "end_date": "2027-02-19",
      "status": "VIGENTE",
      "annulled_date": null,
      "comment": null
    },
    "count": 5,
    "policies": [
      {
        "company": "Interseguro",
        "vehicle_class": "Automóvil",
        "vehicle_use": "Particular",
        "accident_count": 0,
        "policy_number": "0594770702",
        "certificate_number": "0594770702",
        "start_date": "2026-02-19",
        "end_date": "2027-02-19",
        "status": "VIGENTE",
        "annulled_date": null,
        "comment": null
      }
    ]
  }
}
```

<Note>
  O SOAT é o seguro obrigatório de acidentes de trânsito do Peru.
  `accident_count` é a sinistralidade: o número de acidentes cobertos por
  apólices SOAT nos últimos cinco anos. `has_active_soat: false` significa que
  não há uma apólice vigente, mesmo que apólices anteriores apareçam no histórico.
</Note>

<Note>
  Esta consulta pode demorar mais que uma solicitação típica. É um
  [trabalho assíncrono](/pt/async-jobs). Por padrão, a solicitação espera de forma síncrona e
  retorna `{ data }`, ou você pode fazer polling / usar um `callback_url`.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, campos de resposta e um playground interativo.
</Card>