Overview
The Vehicle Documents API provides comprehensive endpoints for managing all required vehicle documentation including:- SOAT (Mandatory Traffic Accident Insurance)
- RTM (Technical-Mechanical Review)
- Insurance Policies (Póliza de Seguro)
Base URL
Authentication
All endpoints require JWT authentication. Include your token in the Authorization header:Endpoints
Document Management
List Documents
Retrieve all vehicle documents with filtering and pagination
Create Document
Add new vehicle documentation records
Update Document
Update existing vehicle documents
Dashboard & Analytics
Dashboard
KPIs, expiration alerts, calendar events, and analytics
Document Types
The API manages three primary document types:| Type | Description | Field Prefix |
|---|---|---|
| SOAT | Mandatory Traffic Accident Insurance | fecha_vencimiento_soat, pdf_soat |
| RTM | Technical-Mechanical Review | fecha_vencimiento_rtm, pdf_rtm |
| Póliza | Insurance Policy | fecha_vencimiento_poliza, pdf_poliza |
Document Status
Documents are automatically categorized based on days until expiration:| Status | Days Remaining | Color |
|---|---|---|
| VENCIDO | < 0 | Red |
| POR_VENCER | 0-30 | Orange |
| PROXIMO | 31-60 | Yellow |
| VIGENTE | > 60 | Green |
| SIN_FECHA | No date | Slate |
Common Response Fields
Unique document identifier
Vehicle license plate number
Operating area or department
SOAT expiration date (ISO 8601 format)
RTM expiration date (ISO 8601 format)
Insurance policy expiration date (ISO 8601 format)
URL to SOAT PDF document
URL to RTM PDF document
URL to insurance policy PDF document
Error Handling
All endpoints return standard HTTP status codes:200- Success201- Created204- No Content (for deletions)400- Bad Request404- Not Found500- Internal Server Error