Occasions
De occasionvoorraad van het Vakgarage-netwerk, op te vragen voor het hele netwerk of voor één vestiging.
De volledige request- en responsestructuur staat in de API-referentie, onder Occasions.
Endpoints
| Methode | Pad | Bereik |
|---|---|---|
GET |
/api/occasions |
alle vestigingen samen |
GET |
/api/occasions/{id} |
één occasion |
GET |
/api/{franchiseId}/occasions |
alleen die vestiging |
GET |
/api/{franchiseId}/occasions/{id} |
één occasion binnen die vestiging |
De responsestructuur is voor beide bereiken identiek; het vestigings-endpoint filtert alleen op de voertuigkoppeling van die garage. Er komen geen velden bij.
Gebruik het vestigingsbereik voor een dealerwebsite die op één garage gericht is, en het netwerkbereik als je het volledige aanbod wilt ontsluiten. Wie welke vestiging mag opvragen, staat in Client types.
Lijst opvragen
Verzoek
GET /api/occasions?page=1&limit=25
| Parameter | Type | Standaard | Beschrijving |
|---|---|---|---|
page |
integer | 1 | paginanummer |
limit |
integer | 25 | aantal per pagina |
De voorraad loopt in de duizenden voertuigen, dus pagineren is geen luxe: vraag niet alles in één keer op.
Antwoord
De pagineringsvelden staan op het hoogste niveau, niet in een meta-object.
{
"data": [
{
"id": 100550764,
"hexon_id": 348,
"dealer_id": 1309,
"licenseplate": "H-781-DG",
"brand": "Peugeot",
"model": "108",
"type": "1.0 e-VTi Active//5DRS // AIRCO",
"price": 7450,
"sold": 0,
"btw": "Volledig belast",
"sale_price": null,
"slug": "/p/100550764/peugeot-108-1-0-e-vti-active-5drs-airco-100550764",
"mileage": 117010,
"color": "Wit",
"build_year": 2020,
"color_type": null,
"fuel_type": "Benzine",
"body_type": "Hatchback",
"vehicle_type": "AUTO",
"transmission": "Handgeschakeld",
"last_seen_at": "2026-09-09 16:30:00",
"first_registration_date": "2020-01-30 00:00:00",
"description": null,
"updated_at": "2026-09-09T09:53:29.000000Z",
"created_at": "2026-04-07T20:42:46.000000Z",
"first_image": "https://media-vakgarage.export.dv.nl/22912859158/image1.jpg"
}
],
"current_page": 1,
"per_page": 25,
"total": 10397
}
Velden in de lijst
| Veld | Type | Beschrijving |
|---|---|---|
id |
integer | het nummer waarmee je één occasion opvraagt |
licenseplate |
string | kenteken |
brand · model · type |
string | merk, model en uitvoering |
price |
integer | vraagprijs in hele euro's |
sale_price |
integer · null | actieprijs; null als die er niet is |
sold |
integer | 0 of 1 |
btw |
string | btw-regeling, bijvoorbeeld Volledig belast of Marge |
mileage |
integer | kilometerstand |
build_year |
integer | bouwjaar |
fuel_type · transmission · body_type |
string | brandstof, transmissie, carrosserie |
color · color_type |
string · null | kleur en kleurtype |
first_image |
string · null | directe URL van de eerste foto |
slug |
string | pad dat je kunt gebruiken voor een detailpagina |
last_seen_at |
string | wanneer dit voertuig voor het laatst in de feed stond |
De lijst bevat geen volledige fotoset, opties of dealergegevens. Die krijg je pas bij één occasion.
Eén occasion
Verzoek
GET /api/occasions/100550764
Antwoord
Alle velden uit de lijst, plus vier blokken:
{
"id": 100550764,
"brand": "Peugeot",
"dealer": {
"id": 1309,
"name": "Vakgarage Nienhuis",
"street": "Omloop 1B",
"zipcode": "8131 TJ",
"town": "Wijhe (Overijssel)",
"country": null,
"phone": "(0570) 52 16 05",
"email": "info@vakgaragenienhuis.nl"
},
"images": [
{
"id": 641822,
"vehicle_id": "100550764",
"image": "https://media-vakgarage.export.dv.nl/22912859158/image1.jpg",
"position": 1
}
],
"options": [
{
"id": 1221427,
"vehicle_id": "100550764",
"option": "Achterbank in delen neerklapbaar"
}
],
"meta": [
{
"id": 231522,
"vehicle_id": "100550764",
"key": "doors",
"value": "5"
}
]
}
De extra blokken
| Blok | Inhoud |
|---|---|
dealer |
de garage waar dit voertuig staat, met adres en contactgegevens |
images |
alle foto's, met position voor de volgorde |
options |
de accessoires en uitvoeringsdetails, als losse regels |
meta |
overige eigenschappen als sleutel-waardeparen, bijvoorbeeld doors |
Sorteer images zelf op position; ga niet uit van de volgorde waarin ze binnenkomen.
meta is bewust een open lijst: welke sleutels erin zitten hangt af van wat de bron aanlevert, dus lees hem uit op sleutel en ga niet uit van een vaste set.