Vencimientos próximos (SOAT, RTM y licencias)

GET

/api/v1/expirations

const url = 'https://notiauto.co/api/v1/expirations?days=30';
const options = {method: 'GET', headers: {'X-API-Key': '<X-API-Key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://notiauto.co/api/v1/expirations?days=30' \
  --header 'X-API-Key: <X-API-Key>'

Requiere el scope vehicles.read. A diferencia de los otros listados, este endpoint no pagina: data es un array plano ordenado por fecha.

Authorizations

ApiKey

Parameters

Query Parameters

days

integer

default: 30

Ventana en días (por defecto 30). Incluye también los ya vencidos.

Responses

200

Vencimientos ordenados por fecha ascendente

application/json

object

success

boolean

data

Array<object>

object

type

string

entity_type

string

Allowed values: vehicle driver

plate

string

driver

string

expiration_date

string format: date

is_valid

boolean

days_remaining

Negativo si ya venció.

integer

meta

object

total

integer

days_filter

integer

Example

{
  "success": true,
  "data": [
    {
      "type": "Soat",
      "entity_type": "vehicle",
      "plate": "ABC123",
      "driver": "ANA GOMEZ",
      "expiration_date": "2026-08-29",
      "is_valid": true,
      "days_remaining": 36
    }
  ],
  "meta": {
    "total": 3,
    "days_filter": 30
  }
}