curl -X GET "https://www.okasie.be/api/external/v1/locations/7f7f7f7f-7f7f-407f-a7f7-7f7f7f7f7f7f/listings?status=active&includeChildren=true" \
-H "Authorization: Bearer YOUR_API_SECRET"
const locationId = "7f7f7f7f-7f7f-407f-a7f7-7f7f7f7f7f7f";
const response = await fetch(
`https://www.okasie.be/api/external/v1/locations/${locationId}/listings?status=active`,
{
headers: {
Authorization: `Bearer ${process.env.PARTNER_SECRET}`,
},
}
);
const data = await response.json();
console.log(`Found ${data.pagination.totalItems} listings`);
{
"data": [
{
"id": "46c7f6c9-70f7-4f98-8c32-12f1a67c6f2e",
"title": "Opel Corsa 1.2 Turbo",
"status": "active",
"price": 19995,
"brand": "Opel",
"model": "Corsa",
"carPassUrl": "https://public.car-pass.be/vhr/example",
"dealer": {
"id": "7f7f7f7f-7f7f-407f-a7f7-7f7f7f7f7f7f",
"locationCode": "DEX-GENT",
"displayName": "DEX Gent"
}
}
],
"pagination": {
"page": 1,
"pageSize": 50,
"totalItems": 45,
"totalPages": 1
},
"meta": {
"partner": {
"id": "partner-id"
}
}
}
Locations
Get Location Listings
Retrieve listings for a specific dealer location
GET
/
api
/
external
/
v1
/
locations
/
{id}
/
listings
curl -X GET "https://www.okasie.be/api/external/v1/locations/7f7f7f7f-7f7f-407f-a7f7-7f7f7f7f7f7f/listings?status=active&includeChildren=true" \
-H "Authorization: Bearer YOUR_API_SECRET"
const locationId = "7f7f7f7f-7f7f-407f-a7f7-7f7f7f7f7f7f";
const response = await fetch(
`https://www.okasie.be/api/external/v1/locations/${locationId}/listings?status=active`,
{
headers: {
Authorization: `Bearer ${process.env.PARTNER_SECRET}`,
},
}
);
const data = await response.json();
console.log(`Found ${data.pagination.totalItems} listings`);
{
"data": [
{
"id": "46c7f6c9-70f7-4f98-8c32-12f1a67c6f2e",
"title": "Opel Corsa 1.2 Turbo",
"status": "active",
"price": 19995,
"brand": "Opel",
"model": "Corsa",
"carPassUrl": "https://public.car-pass.be/vhr/example",
"dealer": {
"id": "7f7f7f7f-7f7f-407f-a7f7-7f7f7f7f7f7f",
"locationCode": "DEX-GENT",
"displayName": "DEX Gent"
}
}
],
"pagination": {
"page": 1,
"pageSize": 50,
"totalItems": 45,
"totalPages": 1
},
"meta": {
"partner": {
"id": "partner-id"
}
}
}
Get Location Listings
Retrieve all listings for a specific dealer location. Supports the same filters as the main listings endpoint.Path Parameters
string
required
Location profile UUID
Query Parameters
boolean
default:"false"
Include listings from child locations
integer
default:"1"
Page number (1-based). Alias:
page_numberinteger
default:"50"
Number of items per page (max 200). Aliases:
page_size, limitstring
default:"active"
Filter by listing status:
active, pending, sold, draft, or allstring
ISO 8601 datetime for incremental sync. Alias:
updated_sincestring
Filter by location code (case-insensitive). Alias:
location_codeResponse
Same response format as List Listings.curl -X GET "https://www.okasie.be/api/external/v1/locations/7f7f7f7f-7f7f-407f-a7f7-7f7f7f7f7f7f/listings?status=active&includeChildren=true" \
-H "Authorization: Bearer YOUR_API_SECRET"
const locationId = "7f7f7f7f-7f7f-407f-a7f7-7f7f7f7f7f7f";
const response = await fetch(
`https://www.okasie.be/api/external/v1/locations/${locationId}/listings?status=active`,
{
headers: {
Authorization: `Bearer ${process.env.PARTNER_SECRET}`,
},
}
);
const data = await response.json();
console.log(`Found ${data.pagination.totalItems} listings`);
{
"data": [
{
"id": "46c7f6c9-70f7-4f98-8c32-12f1a67c6f2e",
"title": "Opel Corsa 1.2 Turbo",
"status": "active",
"price": 19995,
"brand": "Opel",
"model": "Corsa",
"carPassUrl": "https://public.car-pass.be/vhr/example",
"dealer": {
"id": "7f7f7f7f-7f7f-407f-a7f7-7f7f7f7f7f7f",
"locationCode": "DEX-GENT",
"displayName": "DEX Gent"
}
}
],
"pagination": {
"page": 1,
"pageSize": 50,
"totalItems": 45,
"totalPages": 1
},
"meta": {
"partner": {
"id": "partner-id"
}
}
}
Error Responses
| Status | Code | Description |
|---|---|---|
| 401 | UNAUTHORIZED | Invalid or missing API key |
| 404 | NOT_FOUND | Location not found or no access |