List Makes and Models

The makes and models Okasie knows, to map a dealer’s make and model to

GET /api/external/v1/brands

cURL

curl "https://www.okasie.be/api/external/v1/brands"

200

{
  "data": [
    {
      "name": "Volkswagen",
      "models": ["Arteon", "Golf", "ID.3", "Polo", "T-Roc", "Tiguan"]
    },
    {
      "name": "Volvo",
      "models": ["EX30", "V60", "XC40", "XC60", "XC90"]
    }
  ],
  "meta": {
    "version": "4ef1af36ba196e7f",
    "brandCount": 277,
    "modelCount": 4576
  }
}

Returns every make Okasie knows with its models. Stock systems often let dealers type the make and model freely; map those to the names in this list before you send a listing, so the car shows up under the right make and model in Okasie’s search and brand pages.

This endpoint is public: it needs no API key and is not rate limited.

​

Keeping the list up to date

The list is cached for a day. meta.version, also sent as the ETag header, changes whenever the list changes. Fetch it periodically (once a day is enough) and send the last ETag you received as If-None-Match: an unchanged list returns 304 Not Modified without a body, so you only map again when there is something new.

​

How Okasie matches make and model

When you send a listing with Create or Update Listing:

• Make: a make from this list, or a known variant of it, is stored with Okasie’s name. For example VW becomes Volkswagen and Mercedes becomes Mercedes-Benz.
• Model: a model from this list for that make is stored with Okasie’s spelling, ignoring case, spaces and accents. For example XC 40 becomes XC40.
• Not in the list: a make or model that does not match is stored exactly as you sent it. A listing is never refused because of its make or model.

If you have no match for a model, send the dealer’s model as it is rather than a generic value such as “Other”: the listing then keeps the information the dealer entered.

​

Request headers

If-None-Match · string

The ETag of a list you already have. When the list has not changed, the response is 304 without a body.

​

Response

data · object[]

Makes in alphabetical order.

Show make properties

name · string

Okasie’s name of the make, as stored on listings.

models · string[]

Okasie’s model names for this make, in alphabetical order.

meta · object

version (changes whenever the list changes), brandCount and modelCount.

cURL

curl "https://www.okasie.be/api/external/v1/brands"

200

{
  "data": [
    {
      "name": "Volkswagen",
      "models": ["Arteon", "Golf", "ID.3", "Polo", "T-Roc", "Tiguan"]
    },
    {
      "name": "Volvo",
      "models": ["EX30", "V60", "XC40", "XC60", "XC90"]
    }
  ],
  "meta": {
    "version": "4ef1af36ba196e7f",
    "brandCount": 277,
    "modelCount": 4576
  }
}