Bijgewerkt 15 juni 2026
/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();Haal volledige informatie op van een specifiek teamlid aan de hand van het ID. Denk bijvoorbeeld aan het tonen van een visitekaartje van een recruiter naast een vacature.
Authenticatie
Vereist een API sleutel met de team:read scope (inbegrepen in de presets Carrièrewebsite en Chrome plugin). Een sleutel zonder deze scope ontvangt een 403-respons.
Padparameters
| Parameter | Type | Verplicht | Beschrijving |
|---|---|---|---|
id | integer | Ja | Teamlid-ID, exact zoals geretourneerd door GET /team |
Queryparameters
| Parameter | Type | Standaard | Beschrijving |
|---|---|---|---|
include_phone | boolean | false | Telefoonnummer meesturen |
include_role | boolean | false | Rollabel meesturen |
Respons
Retourneert dezelfde velden als het lijstendpoint, maar dan voor één teamlid. De velden phone en role zijn afwezig in de respons tenzij de bijbehorende include_*-vlag wordt meegegeven. Ze worden dus niet als null opgenomen wanneer de vlag niet is ingesteld.
Alleen teamleden die momenteel in dienst zijn, kunnen worden opgehaald. Een verzoek voor een voormalige medewerker of een niet-bestaand ID levert een 404-respons op.
Voorbeeld
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"
}
}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 team:read scope | Voeg de scope toe aan je sleutel of genereer een nieuwe met een preset die deze scope bevat |
404 | Er bestaat geen teamlid met dit ID, of de persoon is niet meer in dienst | Controleer het id via GET /team |