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

# APESEG SOAT Certificate History

> Look up a vehicle plate's SOAT certificate history from APESEG.

Reports the SOAT (mandatory traffic-accident insurance) certificate history on
record for a vehicle plate from APESEG (Asociación Peruana de Empresas de
Seguros). Tells you whether the plate has a currently valid (VIGENTE) SOAT, which
company issued it, and the full history of past certificates. One lookup, by
plate.

## SOAT certificate history

`POST /pe/apeseg/soat/v1`

| Field   | Type   | Notes                                                                                   |
| ------- | ------ | --------------------------------------------------------------------------------------- |
| `plate` | string | **Required.** The vehicle plate to look up, 4-10 characters (letters, digits, hyphens). |

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

## Response

| Field             | Notes                                                                  |
| ----------------- | ---------------------------------------------------------------------- |
| `found`           | `true` when the source returned an answer for the plate.               |
| `plate`           | The searched plate (trimmed, uppercased).                              |
| `has_active_soat` | `true` when the plate has a currently valid (VIGENTE) certificate.     |
| `active`          | The current (VIGENTE) certificate, or `null` when none is active.      |
| `count`           | Number of certificates on record.                                      |
| `certificates[]`  | Certificate history, newest first. Empty when the plate has no record. |

Each certificate (`active` and every `certificates[]` entry) has `company`,
`status` (`VIGENTE` / `VENCIDO` / `ANULADO`), `start_date` and `end_date`
(`yyyy-mm-dd` when parseable), `policy_number`, `vehicle_use`, `vehicle_class`,
`certificate_type` (`DIGITAL` / `FISICO`), `brand`, `model`, `created_date`, and
`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>
  SOAT is Peru's mandatory traffic-accident insurance. `has_active_soat: false`
  means no currently valid certificate is on record for the plate, even if past
  certificates appear in the history.
</Note>

<Note>
  This lookup can take longer than a typical request. It is an
  [async job](/async-jobs). By default the request waits inline and returns
  `{ data }`, or you can poll / use a `callback_url`.
</Note>

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, response fields, and an interactive playground.
</Card>
