development

https://api.dev.it.

fahrzeugmarkt.

online/public/v1

production

https://api.

fahrzeugmarkt.

online/public/v1

X-Authorization

API_KEY

Ask our support team for your API_KEY.

offer

integer

The code of the offer. This can be obtained by using the /offers service.

type

integer | string

The id or the code of the lead-type. This can be obtained by using the /lead-types service.

dealership

integer

The code of the dealership. This can be obtained by using the /dealerships service.

salutation

integer

The code of the salutation. This can be obtained by using the /references/salutations service.

firstname

string

required if category of salutation is PERSON

lastname

string

required if category of salutation is PERSON

company

string

required if category of salutation is COMPANY

phone

string

email

string

message

string

additional-data

array / objekt

paginate

pagination

The maximum value per page is 1000, by default the number per page of items is of 15 if the parameter is not present in the request

GET /offers?paginate=200

Get all the offers with 200 items per page.

code

filter

Filters by the codes. This is required for the “Merkliste”.

GET /offers?filter[code]=100,150

Get all the offers where the code is 100 OR 150

car.brand

filter

List available from service /references/brands

GET /offers?filter[car.brand]=20,23

Get all the offers where the car brand is 20 OR 23

car.model

filter

List available from service /references/brands

GET /offers?filter[car.model]=149

Get all the offers where the car model is 149

car.type

filter

List available from service /references/car-types

GET /offers?filter[car.type]=NW

Get all the offers where the car type code is “NW”

car.body

filter

List available from service /references/car-bodies

GET /offers?filter[car.body]=2,1

Get all the offers where the car body is 2 OR 1

car.transmission

filter

List available from service /references/transmissions

GET /offers?filter[car.transmission]=4

Get all the offers where the car transmission code is 4

car.fuel

filter

List available from service /references/fuels

GET /offers?filter[car.fuel]=1,3

Get all the offers where the car fuel is 1 OR 3

car.firstRegistration

filter

This filter needs a range of values like 2019-01,2020-12. If there is only one value, it will be used as the minimum value.

List available from service /references/first-registration

GET /offers?filter[car.firstRegistration]=2019-01,2019-12

Get all the cars registered between 2019-01 AND 2019-12

car.mileage

filter

This filter needs a range of values like 10000,30000. If there is only one value, it will be used as the minimum value.

List available from service /references/mileage

GET /offers?filter[car.mileage]=0,30000

Get all the cars with mileage between 0 AND 30000

filter

You can combine the filters according to your needs

GET /offers?filter[car.fuel]=1,3&filter[car.brand]=20,23

Get all the offers where the car fuel is 1 OR 3 AND car brand is 20 OR 23

car.brand (ascending)
-car.brand (descending)

sort

GET /offers?sort=car.brand

car.mileage (ascending)
-car.mileage (descending)

sort

GET /offers?sort=car.mileage

car.firstRegistration (ascending)
-car.firstRegistration (descending)

sort

GET /offers?sort=car.firstRegistration

prices.sale.price (ascending)
-prices.sale.price (descending)

sort

GET /offers?sort=prices.sale.price

prices.leasing.grossMonthlyRate (ascending)
-prices.leasing.grossMonthlyRate (descending)

sort

GET /offers?sort=prices.leasing.grossMonthlyRate

prices.rent.grossRentPrice (ascending)
-prices.rent.grossRentPrice (descending)

sort

GET /offers?sort=prices.rent.grossRentPrice

sort

You can combine the sorts according to your needs

GET /offers?sort=car.brand,car.mileage

Sort the offers by the brand and then by the mileage