Bijgewerkt 15 juni 2026
GET
/api/v1/locations
curl -X GET \
"https://app.recruitsome.com/api/v1/locations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"const response = await fetch('https://app.recruitsome.com/api/v1/locations', {
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');
$data = $response->json();Haal een gepagineerde lijst op van je kantoorlocaties, bijvoorbeeld om je kantoren op je carrièresite te tonen, inclusief adressen en optionele kaartcoördinaten.
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.
Queryparameters
| Parameter | Type | Standaard | Beschrijving |
|---|---|---|---|
page | integer | 1 | Paginanummer voor paginering |
per_page | integer | 20 | Items per pagina (max: 100) |
language | string | - | Stel de taal van de respons in voor landnamen (exact 2 tekens) |
country_code | string | - | Filter op landcode (2 tekens, bijv. NL) |
search | string | - | Zoek in naam, stad en adres |
sort | string | name | Sorteerveld: name, locality, created_at |
sort_direction | string | asc | Sorteerrichting: asc of desc |
include_coordinates | boolean | false | Breedtegraad/lengtegraad meenemen |
include_vacancy_count | boolean | false | Aantal vacatures per locatie meenemen |
Responsvelden
| Veld | Type | Beschrijving |
|---|---|---|
id | integer | Uniek locatie-ID |
slug | string | URL-vriendelijke identifier |
name | string | Locatienaam |
address | object | Volledige adresgegevens |
coordinates | object | Breedte-/lengtegraad. Dit veld is afwezig tenzij include_coordinates=true. Het wordt niet als null meegestuurd. |
vacancy_count | integer | Aantal vacatures dat aan deze locatie is gekoppeld. Dit veld is afwezig tenzij include_vacancy_count=true. |
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. Gebruik deze waarde niet als badge voor "openstaande posities" zonder deze te vergelijken met de vacaturelijst.
Adresobject
{
"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"
}Coördinatenobject
{
"latitude": 52.3676,
"longitude": 4.9041
}Voorbeeld
curl -X GET "https://app.recruitsome.com/api/v1/locations?country_code=NL&include_coordinates=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
}
}
],
"links": {
"first": "https://app.recruitsome.com/api/v1/locations?page=1",
"last": "https://app.recruitsome.com/api/v1/locations?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"per_page": 20,
"to": 1,
"total": 1
}
}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 het locations:read-bereik | Voeg het bereik toe aan je sleutel of genereer een nieuwe met de preset Carrièrewebsite |
422 | Ongeldige queryparameter (bijv. language of country_code is niet exact 2 tekens) | Corrigeer de parameter volgens de bovenstaande tabel |
Opmerkingen
- Verwijderde locaties worden automatisch uitgesloten
- Landnamen worden gelokaliseerd op basis van de
language-parameter - De
search-parameter zoekt hoofdletterongevoelig op naam, stad en straatnaam