Estarter [EXT]
  1. Vehiculos
Estarter [EXT]
  • Documentación [Ext API]
  • Endpoints Estarter [external]
    • Servicios
      • Servicios filtos
      • Obtener servicios
    • Microservicios
      • Almacenar archivo PDF
    • Vehiculos
      • Catálogo de Vehículos
        • Crear vehículo en catálogo
        • Listar vehículos del catálogo
        • Editar vehículo del catálogo
      • Sync vehículos [Moove]
        GET
      • Obtener vehiculos
        POST
      • Vehículos filtros
        GET
    • Usuarios
      • Auth Admin
    • Proveedores
      • Agregar o remover proveedor
    • Reservas
      • Obtener reservas por EID y fechas
    • Date server
      GET
    • Invalidar cache
      GET
    • Auth External
      POST
  1. Vehiculos

Obtener vehiculos

POST
/api/v1/external/vehiculos
Este endpoint permite obtener un listado de vehículos con la posibilidad de aplicar filtros dinámicos y paginación. Es accesible únicamente para usuarios autenticados con un token JWT válido.
Para que los filtros tengan consistencia en los resultados se debe implementar primero el servicio o el endpoint de listar filtros "Vehiculos filtros"

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json
placa
string  | null 
optional
estado
string  | null 
optional
marca
string  | null 
optional
linea
string  | null 
optional
modelo
string  | null 
optional
capacidad
string  | null 
optional
vigencia
boolean  | null 
optional
flota_propia
boolean  | null 
optional
pagina
integer 
required
limite
integer 
required
Example
{
    "placa": "string",
    "estado": "string",
    "marca": "string",
    "linea": "string",
    "modelo": "string",
    "capacidad": "string",
    "vigencia": true,
    "flota_propia": true,
    "pagina": 0,
    "limite": 0
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/external/vehiculos' \
--header 'Content-Type: application/json' \
--data-raw '{
    "placa": "string",
    "estado": "string",
    "marca": "string",
    "linea": "string",
    "modelo": "string",
    "capacidad": "string",
    "vigencia": true,
    "flota_propia": true,
    "pagina": 0,
    "limite": 0
}'

Responses

🟢200OK
application/json
Body
resultado
string 
required
datos
array [object {17}] 
required
uuid
string 
optional
placa
string 
optional
clase
string 
optional
marca
string 
optional
linea
string 
optional
modelo
string 
optional
capacidad
integer 
optional
estado
string 
optional
vencimiento_soat
string 
optional
vencimiento_tecnomecanica
string 
optional
vencimiento_preventiva
string 
optional
vencimiento_polizas_rcc
string 
optional
vencimiento_polizas_rce
string 
optional
vencimiento_tarjeta_operacion
string 
optional
proveedor_gps
string 
optional
flota_propia
boolean 
optional
provider_id
number 
optional
Example
{
    "resultado": "OK",
    "datos": [
        {
            "uuid": "5c6ace9e-506c-4c69-9b51-17049b257eba",
            "placa": "LKM225",
            "clase": "CAMIONETA",
            "marca": "RENAULT",
            "linea": "DUSTER ",
            "modelo": "2024",
            "capacidad": 5,
            "estado": "ACTIVO",
            "vencimiento_soat": "2025-12-12T05:00:00.000Z",
            "vencimiento_tecnomecanica": "2025-04-12T05:00:00.000Z",
            "vencimiento_preventiva": "2025-04-17T05:00:00.000Z",
            "vencimiento_polizas_rcc": "2025-09-26T05:00:00.000Z",
            "vencimiento_polizas_rce": "2025-09-26T05:00:00.000Z",
            "vencimiento_tarjeta_operacion": "2026-01-16T05:00:00.000Z",
            "proveedor_gps": "webfleet",
            "flota_propia": true,
            "provider_id": 12122
        }
    ]
}
Modified at 2025-04-13 23:37:23
Previous
Sync vehículos [Moove]
Next
Vehículos filtros
Built with