Updated April 22, 2026
GET
/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();Get Location Details
Retrieve complete information for a specific location by its slug.
Endpoint
GET /api/v1/locations/{slug}
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
slug | string | Yes | URL-friendly location identifier |
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
language | string | - | Set response locale for country names (2 characters) |
include_coordinates | boolean | false | Include latitude/longitude |
include_vacancy_count | boolean | false | Include number of vacancies at this location |
Response
Returns the same fields as the list endpoint for a single location.
Example Request
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"
Example Response
{
"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
}
}
Error Responses
| Code | Description |
|---|---|
| 404 | Location not found |
| 401 | Unauthorized |