Cars

Years

Request Information
URL GEThttps://api.inventario.pro/public/v2/coche?apiKey={{apiKey}}&years=1
Category Cars
Description

This endpoint returns the minimum and maximum years based on the provided API key.

Request

  • apiKey (string, required): The API key for authentication

  • years = 1 (integer, required): Requests the range of years

Response

The response provides an array of objects, each containing "km_minimo" and "km_maximo" fields, representing the minimum and maximum years of all cars in the inventory.

Query Parameters

In addition to the required parameters, the request allows filtering results using specific query parameters. These parameters use prefixes to define different database operations:

Filter Prefixes

  • FILTR_ ( = ) - Exact match for a value.
  • INC_ ( IN ) - Includes any value from an array.
  • EXC_ ( NOT IN ) - Excludes any value from an array.
  • BTW_ ( BETWEEN ) - Defines a range with two values.
  • BT_ ( > ) - Greater than a specific value.
  • ST_ ( < ) - Less than a specific value.

Available Fields

  • marca_id - Car brand identifier.
  • modelo_id - Car model identifier.
  • ad_subtype_id - Body type identifier.
  • precio - Price of the car.
  • combustible_id - Fuel type identifier.
  • cambio_id - Transmission type identifier.
  • estado_id - Status of the car.
  • tipo_id - Offer type.
  • location_id - Location identifier.
  • distintivo_ambiental - Environmental Label identifier.

estado_id Values

  • 1 - En venta (For sale).
  • 2 - Reservado (Reserved).
  • 3 - Vendido (Sold).
  • 4 - En preparación (In preparation).

tipo_id Values

  • 1 - Ocasión (Used).
  • 2 - Nuevo (New).
  • 3 - Km0 (Zero km).
  • 6 - De pruebas (Test vehicle).
  • 7 - Sustitución (Replacement vehicle).
  • 8 - Gerencia (Company car).
  • 9 - Demostración (Demonstration vehicle).

Example Usage

To add filter by brand (marca_id = 5), price range (between 10,000 and 20,000), and available for sale (estado_id = 1):

https://api.inventario.pro/public/v2/coche?{{request_parameters}}&FILTR_marca_id=5&BTW_precio[]=10000&BTW_precio[]=20000&FILTR_estado_id=1
Header
APP-KEY {{appkey}}

Example responses

Years
Response Code:
200OK
Response Body:
[
    {
        "year": "2019"
    },
    {
        "year": "2022"
    }
]