Skip to content

Register License Plate / Registrar Placa

POST
/external/placa
curl --request POST \
--url https://api-dev.zonaparqueo.com/external/placa \
--header 'Authorization: <Authorization>' \
--header 'Content-Type: application/json' \
--data '{ "placa": "ABC123", "tipo_vehiculo_id": 1, "tipo_vehiculo": "example", "electrico": 0, "minusvalido": 0 }'

Registers a license plate in the system. This is the mandatory step 1 of vehicle onboarding: register the plate first, then create the vehicle with POST /external/vehiculo, which links it to a client.

Compatibility note: the verified implementation sends the vehicle type twice, as tipo_vehiculo (string) and tipo_vehiculo_id (integer), to cover both variants accepted by the server.

Media typeapplication/json
object
placa
required

License plate

string
Example
ABC123
tipo_vehiculo_id
required

Vehicle type identifier (see /external/tipo-vehiculo)

integer
Example
1
tipo_vehiculo

Vehicle type as text. Sent alongside tipo_vehiculo_id for compatibility with both variants accepted by the server.

string
electrico

1: is electric; 0: is not electric (optional)

integer
Allowed values: 0 1
minusvalido

1: is disabled; 0: is not disabled (optional)

integer
Allowed values: 0 1

Plate registered successfully

Media typeapplication/json
object
estado
string
Allowed values: ok
data

Response data

object
Examples
Examplesuccess
{
"estado": "ok",
"data": {
"message": "Placa registrada correctamente"
}
}

Validation error

Media typeapplication/json
object
estado
string
Allowed values: fail
error

Error message

string
errores

Field-specific error details

object
Example
{
"estado": "fail"
}