API Documentation

Integra FlotaSegura en tu sistema

API REST completa, documentada con OpenAPI 3.0. Valida conductores y vehículos desde tu TMS, ERP o cualquier aplicación.

Quick StartVer endpoints

Empieza en 3 pasos

1

Obtén tu API Key

Genera una clave desde el panel de configuración

2

Haz tu primera consulta

Envía un POST con el documento del conductor

3

Recibe resultados

JSON estructurado con todas las fuentes en <3s

Request
curl -X POST https://api.flotasegura.com/api/v1/checks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document_type": "CC",
    "document_number": "80123456",
    "first_name": "Juan",
    "last_name": "Pérez",
    "role": "conductor",
    "sources": ["runt", "procuraduria", "contraloria", "policia", "ofac"]
  }'
Response 200 OK
{
  "id": "chk_2026_03847",
  "status": "completed",
  "score": 96,
  "risk_level": "low",
  "results": [
    { "source": "runt", "status": "pass", "response_time_ms": 800 },
    { "source": "procuraduria", "status": "pass", "response_time_ms": 400 },
    { "source": "contraloria", "status": "pass", "response_time_ms": 300 },
    { "source": "policia", "status": "pass", "response_time_ms": 600 },
    { "source": "ofac", "status": "pass", "response_time_ms": 200 }
  ],
  "pdf_url": "/api/v1/checks/chk_2026_03847/pdf",
  "created_at": "2026-03-25T14:23:15Z"
}

Autenticación JWT

Bearer tokens con refresh automático. API keys para integraciones server-to-server.

Webhooks

Notificaciones HTTP en tiempo real cuando una validación se completa o cambia de estado.

JSON everywhere

Request y response en JSON. Documentación OpenAPI 3.0 completa con Swagger UI.

Rate limiting

Protección inteligente con límites por tenant. Headers X-RateLimit-* en cada response.

Endpoints principales

POST/api/v1/checks
GET/api/v1/checks/:id
POST/api/v1/checks/batch
GET/api/v1/checks
POST/api/v1/vehicles
GET/api/v1/vehicles
GET/api/v1/scoring/:checkId
GET/api/v1/audit

Swagger UI interactivo: Explora y prueba todos los endpoints en /api/v1/docs después de iniciar sesión.

¿Listo para integrar?

Solicita tu API key y empieza a validar conductores desde tu sistema hoy mismo.

Obtener API Key