curl "https://www.okasie.be/api/external/v1/brands"
curl "https://www.okasie.be/api/external/v1/brands" \
-H 'If-None-Match: "4ef1af36ba196e7f"'
{
"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
}
}
(no body: the list has not changed)
Brands
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 "https://www.okasie.be/api/external/v1/brands"
curl "https://www.okasie.be/api/external/v1/brands" \
-H 'If-None-Match: "4ef1af36ba196e7f"'
{
"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
}
}
(no body: the list has not changed)
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
VWbecomesVolkswagenandMercedesbecomesMercedes-Benz. - Model: a model from this list for that make is stored with Okasie’s spelling, ignoring case, spaces and accents. For example
XC 40becomesXC40. - 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.
Request headers
string
The
ETag of a list you already have. When the list has not changed, the response is 304 without a body.Response
object[]
object
version (changes whenever the list changes), brandCount and modelCount.curl "https://www.okasie.be/api/external/v1/brands"
curl "https://www.okasie.be/api/external/v1/brands" \
-H 'If-None-Match: "4ef1af36ba196e7f"'
{
"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
}
}
(no body: the list has not changed)