Banners
InventoryCarsArchiveBanner

InventoryCarsArchiveBanner

Archive/listing of inventory cars, optionally with filters.

Includes the common banner props.

inventory cars archive preview

Props

id
string
required

CMS id.

hideFilters
boolean
required

If true, filters UI is hidden.

query
string
required

Backend query string used to fetch the listing.

Supported query params

The query prop accepts a standard URL query string. Multiple params are combined via &. Repeating the same key applies a list filter.

Brand

Filters by brand.

  • Key: BRAND
  • Type: string (repeatable)

Examples:

BRAND=BMW
BRAND=MINI
BRAND=Volkswagen
BRAND=BMW&BRAND=MINI

Model

Filters by car model.

  • Key: MODEL
  • Type: string (repeatable)

Examples:

MODEL=3 Series
MODEL=A4
MODEL=Model 3
MODEL=3 Series&MODEL=X5

Motor

Filters by cars motor type.

  • Key: MOTOR
  • Type: number (repeatable)
  • Allowed values (DriveType):
1  AllWheelDrive
2  FrontWheelDrive
3  RearWheelDrive

Examples:

MOTOR=1
MOTOR=2&MOTOR=3

Gear

Filters by cars gear type.

  • Key: GEAR
  • Type: number (repeatable)
  • Allowed values (TransmissionType):
0  Automatic
1  Manual
2  SemiAutomatic
3  CVT

Examples:

GEAR=0
GEAR=1&GEAR=3

Fuel

Filters by fuel type.

  • Key: FUEL
  • Type: number (repeatable)
  • Allowed values (FuelType):
0   Other
1   Petrol
2   Diesel
3   LPG
4   CNG
6   Electric
7   Hybrid
8   Hydrogen
9   Ethanol
10  HybridDiesel
11  BiFuel

Examples:

FUEL=6
FUEL=1&FUEL=7

Paintwork

Filters by cars paintwork.

  • Key: PAINTWORK
  • Type: string (repeatable)
  • Matching rule: car passes if colors overlaps the provided list.

Examples:

PAINTWORK=Black
PAINTWORK=Black&PAINTWORK=White

Condition

Filters by condition mode.

  • Key: CONDITION
  • Type: string (single)

Allowed values:

DEMONSTRATOR
NEW
USED

Behavior:

  • DEMONSTRATOR: line.isDemonstrator = true
  • NEW: isNew = true and line.isDemonstrator = false
  • USED: isNew = false and line.isDemonstrator = false

Examples:

CONDITION=NEW
CONDITION=DEMONSTRATOR

Payment

Accepted but ignored server-side (currently no effect).

  • Key: PAYMENT
  • Type: string (single)

Example:

PAYMENT=LEASE

Price min / Price max

Filters by cars offer price.

  • Keys: PRICE_MIN, PRICE_MAX
  • Type: number (single)
  • Unit: EUR (UI sends euros; DB stores cents)

Examples:

PRICE_MIN=15000
PRICE_MAX=40000
PRICE_MIN=15000&PRICE_MAX=40000

Km min / Km max

Filters by cars kilometers.

  • Keys: KM_MIN, KM_MAX
  • Type: number (single)
  • Unit: kilometers

Examples:

KM_MIN=0
KM_MAX=50000
KM_MIN=10000&KM_MAX=60000

Registration min / Registration max

Filters by cars first registration.

  • Keys: IR_MIN, IR_MAX
  • Type: string (single)
  • Format: YYYY-MM-DD

Examples:

IR_MIN=2021-01-01
IR_MAX=2023-12-31
IR_MIN=2021-01-01&IR_MAX=2023-12-31

Vehicle class

Filters by vehice class.

  • Key: VCLASS
  • Type: string (repeatable)

Allowed values (VehicleClass):

AgriculturalVehicle
Bus
Car
ConstructionMachine
EBike
ForkliftTruck
Motorbike
Motorhome
SemiTrailer
SemiTrailerTruck
Trailer
TruckOver7500
VanUpTo7500

Examples:

VCLASS=Car
VCLASS=Car&VCLASS=Motorbike

Car type

Filters by car type.

  • Key: CAR_TYPE
  • Type: string (repeatable)

Examples:

CAR_TYPE=SUV
CAR_TYPE=Sedan
CAR_TYPE=SUV&CAR_TYPE=Coupe

Combined examples

status=published&BRAND=BMW&MODEL=3 Series&CONDITION=USED&PRICE_MAX=30000&KM_MAX=60000
status=published&VCLASS=Car&FUEL=6&GEAR=0&MOTOR=2&PAINTWORK=Black&IR_MIN=2022-01-01

Sort options

Creation Date

  • Neueste sort=createdAt&order=desc

  • Älteste sort=createdAt&order=asc

Price

  • Preis: Aufsteigend sort=offerPrice&order=asc

  • Preis: Absteigend sort=offerPrice&order=desc

Mileage

  • Kilometer: Aufsteigend sort=odometerKm&order=asc

  • Kilometer: Absteigend sort=odometerKm&order=desc

Brand

  • Marke (A–Z) sort=make&order=asc

  • Marke (Z–A) sort=make&order=desc

Model

  • Modell (A–Z) sort=model&order=asc

  • Modell (Z–A) sort=model&order=desc

Banner example

const banner: InventoryCarsArchiveBanner = {
  typename: BannerTypename.InventoryCarsArchiveBanner,
  id: 'b_123',
  title: 'Vehicles',
  titleTag: 'h2',
  titleAlign: 'left',
  cssId: null,
  cssClasses: null,
  hideFilters: false,
  query: 'status=published&BRAND=BMW&FUEL=6&PRICE_MAX=40000'
};