Skip to main content
GET
/
vehiculo
/
consulta-placa
/
{placa}
Query License Plate
curl --request GET \
  --url https://api.example.com/vehiculo/consulta-placa/{placa}
{
  "success": false,
  "message": "La placa debe tener al menos una letra inicial y cuatro dígitos como mínimo.",
  "timestamp": "2024-01-15T10:30:00Z"
}

​
Endpoint

​
method
string
default:"GET"
GET
​
endpoint
string
/vehiculo/consulta-placa/

​
Description

Queries vehicle information from the external license plate API without creating a record in the system. This endpoint is useful for previewing vehicle data before creation or for validation purposes.
Only returns results if the vehicle owner belongs to the institution (configurable via PLACA_API_PROPIETARIO_FILTRO environment variable). If the vehicle doesn’t belong to the institution, a 403 error is returned.

​
Path Parameters

​
placa
string
required
Vehicle license plate to query. Will be automatically converted to uppercase and spaces removed.Validation: Must have at least one initial letter and four digits minimum (format: ^[A-Z]{1,}[0-9]{4,}$)Example: "P503067"

​
Validations

Plate Format ValidationThe plate must match the pattern: at least one initial letter followed by at least four digits.
  • Valid: P503067, ABC1234, XY56789
  • Invalid: 1234, AB123, P50 (less than 4 digits)

​
Response

​
success
boolean
Indicates if the operation was successful
​
message
string
Success message: “Información de placa obtenida exitosamente”
​
data
object
Vehicle information from the external API
​
timestamp
string
Response timestamp

​
Example Request

GET /vehiculo/consulta-placa/P503067

​
Example Response

{
  "success": true,
  "message": "Información de placa obtenida exitosamente",
  "data": {
    "placa": "P503067",
    "marca": "TOYOTA",
    "modelo": "HILUX 4X4",
    "anio": 2020,
    "color": "BLANCO",
    "numeroMotor": "1GRFE123456",
    "numeroChasis": "JT123456789012345",
    "numeroVin": "JT123456789012345",
    "claseVehiculo": "Pick-up",
    "propietario": "MINISTERIO DE HACIENDA",
    "fechaTarjetaCirculacion": "2023-12-01",
    "numeroPolizaSeguro": "POL123456789"
  },
  "timestamp": "2024-01-15T10:30:00Z"
}

​
Error Responses

{
  "success": false,
  "message": "La placa debe tener al menos una letra inicial y cuatro dígitos como mínimo.",
  "timestamp": "2024-01-15T10:30:00Z"
}

​
Use Cases

Preview Data

Preview vehicle information before creating a record

Validation

Validate plate exists and belongs to institution

Data Verification

Verify vehicle details match external records

Owner Check

Confirm vehicle ownership before operations

​
Configuration

Environment Variable: PLACA_API_PROPIETARIO_FILTROThis variable configures which institution owners are allowed. Only vehicles belonging to the configured institution will return data from this endpoint.

Build docs developers (and LLMs) love

Get started for freeTalk to us