Cars

Request Information

URL	GEThttps://api.inventario.pro/public/v2/coche?apiKey={{apiKey}}&listado=1&pageSize=20&page=1
Category	Cars

Description

This endpoint makes an HTTP GET request to retrieve a list of cars based on the provided parameters. The request includes the API key, listado, page size and page number.

Request

apiKey (query parameter): The API key for authentication.
listado (query parameter): Indicates the type of list to be retrieved.
pageSize (query parameter): Specifies the number of items per page.
page (query parameter): Indicates the page number for pagination.

Response

The response is in JSON format with a status code of 200. It includes the total count of items and an array of "anuncios" (advertisements) with various details such as ID, customer ID, title, price, photos, and other relevant information.

total (string): Indicates the total count of items.
anuncios (array): Contains the list of advertisements with details such as ID, title, price, photos, and other relevant information.
count (number): Specifies the count of items in the response.

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.
LIKE_titulo ( LIKE ) - Only valid for 'titulo' and applies LIKE '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

Cars

Response Code:

200OK

Response Body:

{
    "total": "4",
    "anuncios": [
        {
            "id": "2285687",
            "customer_id": "1",
            "titulo": "Audi A8 1.9 tdi",
            "version": "1.9 tdi",
            "complemento_titulo": null,
            "precio": null,
            "precio_ant": null,
            "precio_financiado": null,
            "precio_reparacion": "0",
            "precio_pro": null,
            "photop": "",
            "num_photos": "0",
            "tipo_id": "2",
            "version_url": "1-9-tdi",
            "estado_id": "1",
            "ad_subtype_id": "53",
            "modelo_id": "38096",
            "marca_id": "6",
            "cambio_id": "1",
            "location_id": "50",
            "matriculacion_year": null,
            "kilometros": "0",
            "matriculacion_month": null,
            "matricula": null,
            "comentarios_internos": null,
            "puertas": 4,
            "asientos": 5,
            "tienda_name": "Tienda Principal",
            "provincia_name": "Barcelona",
            "ciudad": "Mataró ",
            "combustible_id": "12",
            "tipo_name": "Deportivo",
            "marca_name": "Audi",
            "modelo_name": "A8",
            "combustible_name": "Gasolina",
            "cambio_name": "Automático",
            "potencia": null,
            "destacar_oferta": "0",
            "garantia": null,
            "color_name": "Azul",
            "iva_deducible": "0",
            "impuestos_incluidos": "1",
            "cuota_mensual_financiacion": null,
            "cuota_mensual_calculada": null,
            "cuotas_financiacion": null,
            "producto_financiacion_entrada": "0",
            "producto_financiacion_cuota_final": "0.00",
            "tin_financiacion": null,
            "tae_financiacion": null,
            "texto_legal_financiacion": null,
            "photos": null,
            "distintivo_ambiental_id": null,
            "distintivo_ambiental_nombre": null,
            "marchas": null,
            "consumo_medio": null,
            "tipo_oferta_nombre": "Nuevo",
            "fotos_capas": []
        },
        {
            "id": "2285267",
            "customer_id": "1",
            "titulo": "Citroën C4 1.6 HDi 90 Cool",
            "version": "1.6 HDi 90 Cool",
            "complemento_titulo": null,
            "precio": null,
            "precio_ant": null,
            "precio_financiado": null,
            "precio_reparacion": "0",
            "precio_pro": null,
            "photop": "55ce2eb2-b180-4b6c-bf8e-5b3343ef8cf9",
            "num_photos": "1",
            "tipo_id": "1",
            "version_url": "1-6-hdi-90-cool",
            "estado_id": "1",
            "ad_subtype_id": "83",
            "modelo_id": "38370",
            "marca_id": "17",
            "cambio_id": "1",
            "location_id": "50",
            "matriculacion_year": null,
            "kilometros": "98000",
            "matriculacion_month": null,
            "matricula": null,
            "comentarios_internos": null,
            "puertas": 4,
            "asientos": 5,
            "tienda_name": "Tienda Principal",
            "provincia_name": "Barcelona",
            "ciudad": "Mataró ",
            "combustible_id": "7",
            "tipo_name": "Coche",
            "marca_name": "Citroën",
            "modelo_name": "C4",
            "combustible_name": "Diésel",
            "cambio_name": "Manual",
            "potencia": null,
            "destacar_oferta": "0",
            "garantia": "6",
            "color_name": "Gris",
            "iva_deducible": "0",
            "impuestos_incluidos": "1",
            "cuota_mensual_financiacion": null,
            "cuota_mensual_calculada": null,
            "cuotas_financiacion": null,
            "producto_financiacion_entrada": "0",
            "producto_financiacion_cuota_final": "0.00",
            "tin_financiacion": null,
            "tae_financiacion": null,
            "texto_legal_financiacion": null,
            "photos": "55ce2eb2-b180-4b6c-bf8e-5b3343ef8cf9",
            "distintivo_ambiental_id": null,
            "distintivo_ambiental_nombre": null,
            "marchas": null,
            "consumo_medio": null,
            "tipo_oferta_nombre": "Ocasión",
            "fotos_capas": [
                {
                    "nombre": "55ce2eb2-b180-4b6c-bf8e-5b3343ef8cf9",
                    "orden": "0",
                    "urls": {
                        "original": "https://fotos.inventario.pro/coche/1/2285267/55ce2eb2-b180-4b6c-bf8e-5b3343ef8cf9/40543ad341c7ad9b85737cf1254c2d0f.jpg",
                        "large": "https://fotos.inventario.pro/coche/1/2285267/55ce2eb2-b180-4b6c-bf8e-5b3343ef8cf9/573fc8a10c55ea144dc07b6f0c80c25c.jpg",
                        "medium": "https://fotos.inventario.pro/coche/1/2285267/55ce2eb2-b180-4b6c-bf8e-5b3343ef8cf9/7d212a05d3c85ab7654067f2bb269ccc.jpg",
                        "400px": "https://fotos.inventario.pro/coche/1/2285267/55ce2eb2-b180-4b6c-bf8e-5b3343ef8cf9/b66394bf0b71b5490302fb887f4cbe17.jpg",
                        "small": "https://fotos.inventario.pro/coche/1/2285267/55ce2eb2-b180-4b6c-bf8e-5b3343ef8cf9/1d29c0ffe5b99425359cfdde3141f661.jpg"
                    },
                    "principal": 1
                }
            ]
        },
        {
            "id": "2285452",
            "customer_id": "1",
            "titulo": "Polestar 2 77 kwh",
            "version": "77 kwh",
            "complemento_titulo": null,
            "precio": null,
            "precio_ant": null,
            "precio_financiado": null,
            "precio_reparacion": "0",
            "precio_pro": null,
            "photop": "f69a9fab-5c6f-4b24-8175-48b19c6b8bac",
            "num_photos": "1",
            "tipo_id": "2",
            "version_url": "77-kwh",
            "estado_id": "1",
            "ad_subtype_id": "56",
            "modelo_id": "40541",
            "marca_id": "2125",
            "cambio_id": "1",
            "location_id": "50",
            "matriculacion_year": null,
            "kilometros": "0",
            "matriculacion_month": null,
            "matricula": null,
            "comentarios_internos": null,
            "puertas": 4,
            "asientos": 5,
            "tienda_name": "Tienda Principal",
            "provincia_name": "Barcelona",
            "ciudad": "Mataró ",
            "combustible_id": "8",
            "tipo_name": "Monovolumen",
            "marca_name": "Polestar",
            "modelo_name": "2",
            "combustible_name": "Eléctrico",
            "cambio_name": "Automático",
            "potencia": null,
            "destacar_oferta": "0",
            "garantia": "84",
            "color_name": "Beige",
            "iva_deducible": "0",
            "impuestos_incluidos": "1",
            "cuota_mensual_financiacion": null,
            "cuota_mensual_calculada": null,
            "cuotas_financiacion": null,
            "producto_financiacion_entrada": "0",
            "producto_financiacion_cuota_final": "0.00",
            "tin_financiacion": null,
            "tae_financiacion": null,
            "texto_legal_financiacion": null,
            "photos": "f69a9fab-5c6f-4b24-8175-48b19c6b8bac",
            "distintivo_ambiental_id": null,
            "distintivo_ambiental_nombre": null,
            "marchas": null,
            "consumo_medio": null,
            "tipo_oferta_nombre": "Nuevo",
            "fotos_capas": [
                {
                    "nombre": "f69a9fab-5c6f-4b24-8175-48b19c6b8bac",
                    "orden": "0",
                    "urls": {
                        "original": "https://fotos.inventario.pro/coche/1/2285452/f69a9fab-5c6f-4b24-8175-48b19c6b8bac/40543ad341c7ad9b85737cf1254c2d0f.jpg",
                        "large": "https://fotos.inventario.pro/coche/1/2285452/f69a9fab-5c6f-4b24-8175-48b19c6b8bac/573fc8a10c55ea144dc07b6f0c80c25c.jpg",
                        "medium": "https://fotos.inventario.pro/coche/1/2285452/f69a9fab-5c6f-4b24-8175-48b19c6b8bac/7d212a05d3c85ab7654067f2bb269ccc.jpg",
                        "400px": "https://fotos.inventario.pro/coche/1/2285452/f69a9fab-5c6f-4b24-8175-48b19c6b8bac/b66394bf0b71b5490302fb887f4cbe17.jpg",
                        "small": "https://fotos.inventario.pro/coche/1/2285452/f69a9fab-5c6f-4b24-8175-48b19c6b8bac/1d29c0ffe5b99425359cfdde3141f661.jpg"
                    },
                    "principal": 1
                }
            ]
        },
        {
            "id": "2285260",
            "customer_id": "1",
            "titulo": "Volkswagen Polo Advance 1.6 TDI 70 kW (95 CV)",
            "version": "Advance 1.6 TDI 70 kW (95 CV)",
            "complemento_titulo": null,
            "precio": null,
            "precio_ant": null,
            "precio_financiado": null,
            "precio_reparacion": "0",
            "precio_pro": null,
            "photop": "6df39cf6-1a09-4f3c-9a47-c8bea92efece",
            "num_photos": "1",
            "tipo_id": "1",
            "version_url": "advance-1-6-tdi-70-kw-95-cv",
            "estado_id": "1",
            "ad_subtype_id": "54",
            "modelo_id": "39617",
            "marca_id": "76",
            "cambio_id": "1",
            "location_id": "50",
            "matriculacion_year": null,
            "kilometros": "12000",
            "matriculacion_month": null,
            "matricula": "5533LKM",
            "comentarios_internos": null,
            "puertas": 4,
            "asientos": 5,
            "tienda_name": "Tienda Principal",
            "provincia_name": "Barcelona",
            "ciudad": "Mataró ",
            "combustible_id": "7",
            "tipo_name": "Sedan",
            "marca_name": "Volkswagen",
            "modelo_name": "Polo",
            "combustible_name": "Diésel",
            "cambio_name": "Manual",
            "potencia": "95",
            "destacar_oferta": "0",
            "garantia": "36",
            "color_name": "Azul",
            "iva_deducible": "0",
            "impuestos_incluidos": "1",
            "cuota_mensual_financiacion": null,
            "cuota_mensual_calculada": null,
            "cuotas_financiacion": null,
            "producto_financiacion_entrada": "0",
            "producto_financiacion_cuota_final": "0.00",
            "tin_financiacion": null,
            "tae_financiacion": null,
            "texto_legal_financiacion": null,
            "photos": "6df39cf6-1a09-4f3c-9a47-c8bea92efece",
            "distintivo_ambiental_id": null,
            "distintivo_ambiental_nombre": null,
            "marchas": "5",
            "consumo_medio": null,
            "tipo_oferta_nombre": "Ocasión",
            "fotos_capas": [
                {
                    "nombre": "6df39cf6-1a09-4f3c-9a47-c8bea92efece",
                    "orden": "0",
                    "urls": {
                        "original": "https://fotos.inventario.pro/coche/1/2285260/6df39cf6-1a09-4f3c-9a47-c8bea92efece/40543ad341c7ad9b85737cf1254c2d0f.jpg",
                        "large": "https://fotos.inventario.pro/coche/1/2285260/6df39cf6-1a09-4f3c-9a47-c8bea92efece/573fc8a10c55ea144dc07b6f0c80c25c.jpg",
                        "medium": "https://fotos.inventario.pro/coche/1/2285260/6df39cf6-1a09-4f3c-9a47-c8bea92efece/7d212a05d3c85ab7654067f2bb269ccc.jpg",
                        "400px": "https://fotos.inventario.pro/coche/1/2285260/6df39cf6-1a09-4f3c-9a47-c8bea92efece/b66394bf0b71b5490302fb887f4cbe17.jpg",
                        "small": "https://fotos.inventario.pro/coche/1/2285260/6df39cf6-1a09-4f3c-9a47-c8bea92efece/1d29c0ffe5b99425359cfdde3141f661.jpg"
                    },
                    "principal": 1
                }
            ]
        }
    ],
    "count": 4
}

Cars

Campers

Locations

Cars

Cars

Request

Response

Filter Prefixes

Available Fields

estado_id Values

tipo_id Values

Example Usage

Example responses

Response Code:

Response Body: