Banners
CarDealsArchiveBanner

CarDealsArchiveBanner

Archive/listing of car deals, optionally with filters.

Includes the common banner props.

Car deal 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 &.

Brand

Filters by manufacturer.

  • Type: string
  • Value: Arbitrary brand name (must match backend data exactly)

Examples:

brand=BMW brand=MINI brand=Volkswagen

Multiple brands:

brand=BMW&brand=MINI

Series

Filters by model series.

  • Type: string
  • Value: Arbitrary series name (must match backend data exactly)

Examples:

series=3 Series series=A4 series=Model 3

Combined with brand:

brand=BMW&series=3 Series

Offer type

Filters by deal offer type.

  • Type: DealOfferTypeType
  • Allowed values:
    PRIVAT
    COMMERCIAL
    BUSINESS
    SPECIAL

Examples:

offerType=PRIVAT offerType=BUSINESS

Fuel type

Filters by drivetrain / fuel type.

  • Type: CarFuelType
  • Allowed values:
    ELECTRICITY
    PETROL
    DIESEL
    LPG
    ETHANOL
    CNG
    HYBRID
    HYBRID_DIESEL
    HYDROGENIUM

Examples:

fuelType=ELECTRICITY fuelType=HYBRID fuelType=DIESEL

Combined Example

brand=BMW&offerType=PRIVAT&fuelType=PETROL

Sort options

Lifecycle

  • Neueste Deals zuerst sort=createdAt&order=desc

  • Älteste Deals zuerst sort=createdAt&order=asc

  • Zuletzt aktualisiert sort=updatedAt&order=desc

  • Am längsten unverändert sort=updatedAt&order=asc

Validity

  • Gültig ab: Neueste zuerst sort=validFrom&order=desc

  • Gültig ab: Älteste zuerst sort=validFrom&order=asc

  • Gültig bis: Bald zuerst sort=validUntil&order=asc

  • Gültig bis: Später zuerst sort=validUntil&order=desc

Pricing (Gross)

  • Monatsrate: Niedrig → Hoch sort=monthlyRateGross&order=asc

  • Monatsrate: Hoch → Niedrig sort=monthlyRateGross&order=desc

  • Kaufpreis: Niedrig → Hoch sort=purchasePriceGross&order=asc

  • Kaufpreis: Hoch → Niedrig sort=purchasePriceGross&order=desc

  • Gesamtpreis: Niedrig → Hoch sort=totalPriceGross&order=asc

  • Gesamtpreis: Hoch → Niedrig sort=totalPriceGross&order=desc

  • Rabatt: Hoch → Niedrig sort=discountAmountGross&order=desc

  • Rabatt: Niedrig → Hoch sort=discountAmountGross&order=asc

Contract Characteristics

  • Laufzeit: Kurz → Lang sort=termMonths&order=asc

  • Laufzeit: Lang → Kurz sort=termMonths&order=desc

  • Jahreskilometer: Niedrig → Hoch sort=annualMileage&order=asc

  • Jahreskilometer: Hoch → Niedrig sort=annualMileage&order=desc

Example

const banner: CarDealsArchiveBanner = {
  typename: BannerTypename.CarDealsArchiveBanner,
  id: 'b_123',
  title: 'Offers',
  titleTag: 'h2',
  titleAlign: 'left',
  cssId: null,
  cssClasses: null,
  hideFilters: false,
  query: 'status=published'
};