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

> Consulta el historial de siniestralidad SOAT y las pólizas de una placa en la SBS.

Reporta el registro SOAT (Seguro Obligatorio de Accidentes de Tránsito) de una
placa vehicular en la SBS (Superintendencia de Banca, Seguros y AFP), el
regulador peruano de banca y seguros. Devuelve la siniestralidad (número de
accidentes coberturados por pólizas SOAT en los últimos 5 años) y la lista de
pólizas SOAT registradas: compañía aseguradora, clase y uso del vehículo,
accidentes por póliza, vigencia y estado. Una consulta, por placa.

## Reporte SOAT

`POST /pe/sbs/soat/v1`

| Campo   | Tipo   | Notas                                                                                        |
| ------- | ------ | -------------------------------------------------------------------------------------------- |
| `plate` | string | **Requerido.** La placa vehicular a consultar, 4 a 10 caracteres (letras, dígitos, guiones). |

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

## Respuesta

| Campo             | Notas                                                                                               |
| ----------------- | --------------------------------------------------------------------------------------------------- |
| `found`           | `true` cuando la fuente reporta información SOAT para la placa.                                     |
| `plate`           | La placa consultada (sin espacios, en mayúsculas).                                                  |
| `report_date`     | Momento en que la fuente generó el reporte (ISO, cuando es interpretable).                          |
| `data_through`    | La etiqueta de actualización de datos de la fuente (por ejemplo `ABRIL 2026`).                      |
| `accident_count`  | Accidentes coberturados por SOAT en los últimos 5 años (siniestralidad).                            |
| `has_active_soat` | `true` cuando hay una póliza vigente (VIGENTE).                                                     |
| `active`          | La póliza vigente (VIGENTE), o `null` cuando ninguna está activa.                                   |
| `count`           | Número de pólizas registradas.                                                                      |
| `policies[]`      | Historial de pólizas, de la más reciente a la más antigua. Vacío cuando la placa no tiene registro. |

Cada póliza (`active` y cada entrada de `policies[]`) tiene `company`,
`vehicle_class`, `vehicle_use`, `accident_count`, `policy_number`,
`certificate_number`, `start_date` y `end_date` (`yyyy-mm-dd` cuando es
interpretable), `status` (`VIGENTE` / `VENCIDA` / `ANULADA`), `annulled_date` y
`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>
  El SOAT es el seguro obligatorio de accidentes de tránsito del Perú.
  `accident_count` es la siniestralidad: el número de accidentes coberturados por
  pólizas SOAT en los últimos cinco años. `has_active_soat: false` significa que
  no hay una póliza vigente, aunque aparezcan pólizas anteriores en el historial.
</Note>

<Note>
  Esta consulta puede tardar más que una petición típica. Es un
  [trabajo asíncrono](/async-jobs). Por defecto la petición espera en línea y
  devuelve `{ data }`, o puedes hacer polling / usar un `callback_url`.
</Note>

<Card title="Referencia completa" icon="code" href="/api-reference/overview">
  Esquemas, campos de respuesta y un playground interactivo.
</Card>
