GET /listings
Meldingen opvragen
Publieke meldingen, nieuwste eerst. Filter op status, soort en plaats. Synchroniseer met updated_since en If-None-Match. Een identiek verzoek binnen 60 seconden krijgt het vorige antwoord uit de cache.
Parameters
| Naam | Waar | Type | Beschrijving |
|---|---|---|---|
status | query | string | Komma-gescheiden: missing, found, seen, home. |
species | query | string | Komma-gescheiden: cat, dog, bird, small_mammal, reptile, horse, other. |
province | query | string | Provincie-slug (zie /gemeenten). Niet samen met gemeente of near. |
gemeente | query | string | Gemeente-slug of NIS-code (zie /gemeenten). |
near | query | string | Belgische postcode: meldingen in gemeenten waarvan het centrum binnen radius km ligt (afstand tussen gemeentecentra, nooit exacte locaties). |
radius | query | integer 1–25 | Straal in km (1–25, standaard 10), alleen met near. |
updated_since | query | string | Alleen meldingen die sindsdien gewijzigd zijn (ISO 8601). Basis van de synchronisatie. |
sort | query | string (-reported_at, reported_at, -updated_at, updated_at) = -reported_at | Sortering; een minteken betekent nieuwste eerst. |
page | query | integer 1–100 = 1 | Pagina (max. 100). Voor een volledige synchronisatie gebruik je updated_since. |
per_page | query | integer 1–100 = 25 | Resultaten per pagina (max. 100). |
lang | query | string (nl, fr, en, de) = nl | Taal van de labels en links (de link opent de melding in die taal). |
If-None-Match | header | string | ETag van je vorige antwoord: ongewijzigd → 304 zonder body. |
If-Modified-Since | header | string | Last-Modified van je vorige antwoord. |
Voorbeeldverzoek
curl
curl -s "https://ikbenvermist.be/wp-json/ibv/api/v1/listings?status=missing&gemeente=hasselt&lang=nl" \
-H "Authorization: Bearer $IBV_API_KEY" \
-H 'If-None-Match: W/"…"'JavaScript
// on your server (Node 18+), never in the browser
const res = await fetch('https://ikbenvermist.be/wp-json/ibv/api/v1/listings?status=missing&gemeente=hasselt&lang=nl', {
headers: { Authorization: `Bearer ${process.env.IBV_API_KEY}` },
});
if (res.status === 429) { /* wait res.headers.get('Retry-After') seconds */ }
const body = await res.json();PHP
$ch = curl_init('https://ikbenvermist.be/wp-json/ibv/api/v1/listings?status=missing&gemeente=hasselt&lang=nl');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('IBV_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);Voorbeeldantwoord 200
{
"data": [
{
"id": 900001,
"status": "missing",
"status_label": "Vermist",
"species": "cat",
"species_label": "Kat",
"place": {
"gemeente": "Hasselt",
"gemeente_slug": "hasselt",
"nis": "71022",
"province": "Limburg",
"province_slug": "limburg"
},
"reported_at": "2026-10-10T08:12:00Z",
"updated_at": "2026-10-11T17:40:00Z",
"url": "https://ikbenvermist.be/m/900001/?utm_source=jouw-organisatie&utm_medium=api&utm_campaign=api",
"links": {
"self": "https://ikbenvermist.be/wp-json/ibv/api/v1/listings/900001",
"html": "https://ikbenvermist.be/m/900001/?utm_source=jouw-organisatie&utm_medium=api&utm_campaign=api",
"gemeente": "https://ikbenvermist.be/?utm_source=jouw-organisatie&utm_medium=api&utm_campaign=api"
}
},
{
"id": 900002,
"status": "found",
"status_label": "Gevonden",
"species": "dog",
"species_label": "Hond",
"place": {
"gemeente": "Gent",
"gemeente_slug": "gent",
"nis": "44021",
"province": "Oost-Vlaanderen",
"province_slug": "oost-vlaanderen"
},
"reported_at": "2026-10-09T14:03:00Z",
"updated_at": "2026-10-09T14:03:00Z",
"url": "https://ikbenvermist.be/m/900002/?utm_source=jouw-organisatie&utm_medium=api&utm_campaign=api",
"links": {
"self": "https://ikbenvermist.be/wp-json/ibv/api/v1/listings/900002",
"html": "https://ikbenvermist.be/m/900002/?utm_source=jouw-organisatie&utm_medium=api&utm_campaign=api",
"gemeente": "https://ikbenvermist.be/?utm_source=jouw-organisatie&utm_medium=api&utm_campaign=api"
}
}
],
"meta": {
"page": 1,
"per_page": 2,
"total": 6,
"total_pages": 3,
"lang": "nl",
"generated_at": "2026-10-15T00:13:44Z"
},
"links": {
"self": "https://ikbenvermist.be/wp-json/ibv/api/v1/listings?lang=nl&per_page=2&page=1",
"first": "https://ikbenvermist.be/wp-json/ibv/api/v1/listings?lang=nl&per_page=2&page=1",
"last": "https://ikbenvermist.be/wp-json/ibv/api/v1/listings?lang=nl&per_page=2&page=3",
"next": "https://ikbenvermist.be/wp-json/ibv/api/v1/listings?lang=nl&per_page=2&page=2",
"docs": "https://ikbenvermist.be/en/api/documentation/"
}
}