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

> Consulte o histórico de certificados SOAT de uma placa veicular na APESEG.

Reporta o histórico de certificados SOAT (Seguro Obligatorio de Accidentes de
Tránsito) registrados para uma placa veicular na APESEG (Asociación Peruana de
Empresas de Seguros). Indica se a placa tem um SOAT vigente, qual companhia o
emitiu e o histórico completo de certificados anteriores. Uma consulta, por
placa.

## Histórico de certificados SOAT

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

## Resposta

| Campo             | Notas                                                                                             |
| ----------------- | ------------------------------------------------------------------------------------------------- |
| `found`           | `true` quando a fonte retornou uma resposta para a placa.                                         |
| `plate`           | A placa consultada (sem espaços, em maiúsculas).                                                  |
| `has_active_soat` | `true` quando a placa tem um certificado vigente (VIGENTE).                                       |
| `active`          | O certificado vigente (VIGENTE), ou `null` quando nenhum está ativo.                              |
| `count`           | Número de certificados registrados.                                                               |
| `certificates[]`  | Histórico de certificados, do mais recente ao mais antigo. Vazio quando a placa não tem registro. |

Cada certificado (`active` e cada entrada de `certificates[]`) tem `company`,
`status` (`VIGENTE` / `VENCIDO` / `ANULADO`), `start_date` e `end_date`
(`yyyy-mm-dd` quando interpretável), `policy_number`, `vehicle_use`,
`vehicle_class`, `certificate_type` (`DIGITAL` / `FISICO`), `brand`, `model`,
`created_date` e `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>
  O SOAT é o seguro obrigatório de acidentes de trânsito do Peru.
  `has_active_soat: false` significa que não há um certificado vigente registrado
  para a placa, mesmo que certificados 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>