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

# Historial de SOAT APESEG

> Consulta el historial de certificados SOAT de una placa vehicular en APESEG.

Reporta el historial de certificados SOAT (Seguro Obligatorio de Accidentes de
Tránsito) registrados para una placa vehicular en APESEG (Asociación Peruana de
Empresas de Seguros). Indica si la placa tiene un SOAT vigente, qué compañía lo
emitió y el historial completo de certificados anteriores. Una consulta, por
placa.

## Historial de certificados SOAT

`POST /pe/apeseg/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/apeseg/soat/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "plate": "ABC123" }'
```

## Respuesta

| Campo             | Notas                                                                                                |
| ----------------- | ---------------------------------------------------------------------------------------------------- |
| `found`           | `true` cuando la fuente devolvió una respuesta para la placa.                                        |
| `plate`           | La placa consultada (sin espacios, en mayúsculas).                                                   |
| `has_active_soat` | `true` cuando la placa tiene un certificado vigente (VIGENTE).                                       |
| `active`          | El certificado vigente (VIGENTE), o `null` cuando ninguno está activo.                               |
| `count`           | Número de certificados registrados.                                                                  |
| `certificates[]`  | Historial de certificados, del más reciente al más antiguo. Vacío cuando la placa no tiene registro. |

Cada certificado (`active` y cada entrada de `certificates[]`) tiene `company`,
`status` (`VIGENTE` / `VENCIDO` / `ANULADO`), `start_date` y `end_date`
(`yyyy-mm-dd` cuando es interpretable), `policy_number`, `vehicle_use`,
`vehicle_class`, `certificate_type` (`DIGITAL` / `FISICO`), `brand`, `model`,
`created_date` y `annulled_date`.

```json theme={"dark"}
{
  "data": {
    "found": true,
    "plate": "ABC123",
    "has_active_soat": true,
    "active": {
      "company": "Interseguro",
      "status": "VIGENTE",
      "start_date": "2026-02-19",
      "end_date": "2027-02-19",
      "policy_number": "000000000000000594770702",
      "vehicle_use": "PARTICULAR",
      "vehicle_class": "AUTOMOVIL",
      "certificate_type": "DIGITAL",
      "brand": "JEEP",
      "model": "COMPASS",
      "created_date": "2026-02-19",
      "annulled_date": null
    },
    "count": 10,
    "certificates": [
      {
        "company": "Interseguro",
        "status": "VIGENTE",
        "start_date": "2026-02-19",
        "end_date": "2027-02-19",
        "policy_number": "000000000000000594770702",
        "vehicle_use": "PARTICULAR",
        "vehicle_class": "AUTOMOVIL",
        "certificate_type": "DIGITAL",
        "brand": "JEEP",
        "model": "COMPASS",
        "created_date": "2026-02-19",
        "annulled_date": null
      }
    ]
  }
}
```

<Note>
  El SOAT es el seguro obligatorio de accidentes de tránsito del Perú.
  `has_active_soat: false` significa que no hay un certificado vigente registrado
  para la placa, aunque aparezcan certificados 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>