Updated June 15, 2026
GET
/api/v1/team/{id}
curl -X GET \
"https://app.recruitsome.com/api/v1/team/{id}" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"const response = await fetch('https://app.recruitsome.com/api/v1/team/{id}', {
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/team/{id}');
$data = $response->json();Retrieve complete information for a specific team member by their ID — for example to render a recruiter's contact card next to a vacancy.
Authentication
Requires an API key with the team:read scope (included in the Career website and Chrome plugin presets). A key without this scope receives a 403 response.
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | integer | Yes | Team member ID, exactly as returned by GET /team |
Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
include_phone | boolean | false | Include phone number |
include_role | boolean | false | Include role label |
Response
Returns the same fields as the list endpoint for a single team member. The phone and role keys are absent from the response unless their include_* flag is passed — they are not included as null when the flag is off.
Only currently employed team members can be retrieved. Requesting a former employee or non-existent ID returns a 404 response.
Example
curl -X GET "https://app.recruitsome.com/api/v1/team/8?include_phone=true&include_role=true" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"Response 200
{
"data": {
"id": 8,
"given_name": "Femke",
"family_name": "Bakker",
"full_name": "Femke Bakker",
"job_title": "HR Manager",
"email": "[email protected]",
"phone": "+31612345678",
"avatar": {
"small": "https://app.recruitsome.com/media/avatars/8/small.jpg",
"medium": "https://app.recruitsome.com/media/avatars/8/medium.jpg",
"large": "https://app.recruitsome.com/media/avatars/8/large.jpg"
},
"role": "HR Manager"
}
}Error responses
| Status | When | Fix |
|---|---|---|
401 | Missing or invalid API key | Send a valid key as Authorization: Bearer YOUR_API_KEY |
403 | API key lacks the team:read scope | Add the scope to your key or regenerate it with a preset that includes it |
404 | No team member with this ID, or the person is no longer employed | Check the id against GET /team |