List Vehicles / Listar Vehiculos

GET

/external/vehiculos

const url = 'https://api-dev.zonaparqueo.com/external/vehiculos?cliente_id=1';
const options = {method: 'GET', headers: {Authorization: '<Authorization>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api-dev.zonaparqueo.com/external/vehiculos?cliente_id=1' \
  --header 'Authorization: <Authorization>'

Gets a paginated list of vehicles for a client.

Important: unlike /external/cliente-email, this endpoint does read filters from the query string. Sending them in the JSON body makes the server silently ignore them and return an unfiltered global page, which can lead to associating a vehicle with the wrong client. Always send cliente_id (and placa when applicable) as query parameters.

Authorizations

ApiToken

Parameters

Query Parameters

cliente_id

required

integer

Client identifier

placa

string

Filter by license plate (optional)

nombre

string

Filter by vehicle name (optional)

Responses

200

List of vehicles

application/json

object

estado

string

Allowed values: ok

data

Array<object>

object

Vehicle identifier

integer

nombre

Vehicle name or alias

string

placa

License plate

string

cliente_id

Client identifier

integer

activado

Activation status

integer

favorito

Marked as favorite

integer

total

integer

per_page

integer

current_page

integer

last_page

integer

Examples

success

{
  "estado": "ok",
  "data": [
    {
      "id": 10,
      "nombre": "Mi carro",
      "placa": "ABC123",
      "cliente_id": 5,
      "activado": 1,
      "favorito": 0
    },
    {
      "id": 11,
      "nombre": "Moto",
      "placa": "XYZ789",
      "cliente_id": 5,
      "activado": 1,
      "favorito": 1
    }
  ],
  "total": 2,
  "per_page": 15,
  "current_page": 1,
  "last_page": 1
}

400

Invalid request

application/json

object

estado

string

Allowed values: fail

error

Error message

string

errores

Field-specific error details

object

Example

{
  "estado": "fail"
}