Bijgewerkt 15 juni 2026
/api/v1/locations/{slug}
curl -X GET \
"https://app.recruitsome.com/api/v1/locations/{slug}" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"const response = await fetch('https://app.recruitsome.com/api/v1/locations/{slug}', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Accept': 'application/json',
},
});
const data = await response.json();
console.log(data);use Illuminate\Support\Facades\Http;
$response = Http::withToken('YOUR_API_KEY')
->acceptJson()
->get('https://app.recruitsome.com/api/v1/locations/{slug}');
$data = $response->json();Haal volledige informatie op voor een specifieke locatie aan de hand van de slug. Denk bijvoorbeeld aan het tonen van een kantoorpagina met adres, kaartcoördinaten en het aantal gekoppelde vacatures.
Authenticatie
Vereist een API sleutel met de locations:read scope (inbegrepen in het Carrièrewebsite-preset). Een sleutel zonder deze scope ontvangt een 403-respons.
Padparameters
| Parameter | Type | Verplicht | Beschrijving |
|---|---|---|---|
slug | string | Ja | URL-vriendelijke locatie-identifier, exact zoals geretourneerd door GET /locations |
Queryparameters
| Parameter | Type | Standaard | Beschrijving |
|---|---|---|---|
language | string | - | Stel de taal van de respons in voor landnamen (exact 2 tekens) |
include_coordinates | boolean | false | Voeg breedte- en lengtegraad toe |
include_vacancy_count | boolean | false | Voeg het aantal vacatures op deze locatie toe |
Respons
Retourneert dezelfde velden als het lijstendpoint, maar dan voor één locatie. De velden coordinates en vacancy_count zijn afwezig in de respons tenzij de bijbehorende include_*-vlag wordt meegegeven. Ze worden dus niet als null opgenomen.
vacancy_count telt alle vacatures die aan de locatie zijn gekoppeld, inclusief concepten, gesloten en niet-gepubliceerde vacatures. Het gaat dus niet alleen om de vacatures die momenteel zichtbaar zijn via GET /vacancies.
Voorbeeld
curl -X GET "https://app.recruitsome.com/api/v1/locations/amsterdam-office-amsterdam-nl?include_coordinates=true&include_vacancy_count=true" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"Response 200
{
"data": {
"id": 1,
"slug": "amsterdam-office-amsterdam-nl",
"name": "Amsterdam Office",
"address": {
"address_line_1": "Keizersgracht 100",
"address_line_2": null,
"address_line_3": null,
"locality": "Amsterdam",
"administrative_area": "North Holland",
"postal_code": "1015 AA",
"country_code": "NL",
"country_name": "Netherlands"
},
"coordinates": {
"latitude": 52.3676,
"longitude": 4.9041
},
"vacancy_count": 5
}
}Foutresponses
| Status | Wanneer | Oplossing |
|---|---|---|
401 | Ontbrekende of ongeldige API sleutel | Stuur een geldige sleutel mee als Authorization: Bearer YOUR_API_KEY |
403 | De API sleutel mist de scope locations:read | Voeg de scope toe aan je sleutel of genereer een nieuwe met de preset Carrièrewebsite |
404 | Er bestaat geen locatie met deze slug (verwijderde locaties geven ook 404) | Controleer de slug via GET /locations |
422 | Ongeldige queryparameter (bijvoorbeeld language is niet exact 2 tekens) | Corrigeer de parameter volgens de bovenstaande tabel |