Bijgewerkt 15 juni 2026
/api/v1/team
curl -X GET \
"https://app.recruitsome.com/api/v1/team" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"const response = await fetch('https://app.recruitsome.com/api/v1/team', {
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');
$data = $response->json();Haal een gepagineerde lijst op van actieve teamleden. Ideaal voor de sectie "maak kennis met het team" of "jouw recruiters" op je website.
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.
Standaardfiltering
Dit endpoint retourneert alleen momenteel in dienst zijnde interne teamleden. Voormalige medewerkers en externe portalgebruikers (self-service medewerkers en goedkeurders) worden automatisch uitgesloten.
Queryparameters
| Parameter | Type | Standaard | Beschrijving |
|---|---|---|---|
page | integer | 1 | Paginanummer voor paginering |
per_page | integer | 20 | Items per pagina (max: 100) |
search | string | - | Zoek op naam, e-mailadres en functietitel |
job_title | string | - | Filter op functietitel (gedeeltelijke overeenkomst) |
role | string | - | Filter op rolnaam (bijv. administrator, hr_manager, recruiter) |
has_avatar | boolean | false | Retourneer alleen leden met een geüploade avatar |
sort | string | given_name | Sorteerveld: given_name, family_name, job_title |
sort_direction | string | asc | Sorteerrichting: asc of desc |
include_phone | boolean | false | Telefoonnummer meenemen |
include_role | boolean | false | Rollabel meenemen |
Antwoordvelden
| Veld | Type | Beschrijving |
|---|---|---|
id | integer | Teamlid-ID. Gebruik dit voor GET /team/{id} |
given_name | string | Voornaam |
family_name | string | Achternaam |
full_name | string | Volledige naam |
job_title | string|null | Functietitel |
email | string | E-mailadres |
phone | string|null | Telefoonnummer in E.164-formaat (null als er geen is ingesteld). Dit veld is alleen aanwezig als include_phone=true. Wanneer de vlag uit staat, wordt het niet als null meegestuurd. |
avatar | object | Avatar-afbeeldings-URL's in meerdere formaten |
role | string|null | Rollabel (null als het lid geen rol heeft). Dit veld is alleen aanwezig als include_role=true. |
Avatar-object
Avatar-afbeeldingen worden in drie formaten aangeboden. Elk formaat is null als er geen avatar is geüpload.
{
"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"
}| Formaat | Afmetingen | Toepassing |
|---|---|---|
small | 128x128 | Lijsten, kaarten |
medium | 256x256 | Profielsecties, headers |
large | 512x512 | Volledige profielweergaven |
Voorbeeld
curl -X GET "https://app.recruitsome.com/api/v1/team?has_avatar=true&include_role=true&sort=family_name" \
-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]",
"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"
}
],
"links": {
"first": "https://app.recruitsome.com/api/v1/team?page=1",
"last": "https://app.recruitsome.com/api/v1/team?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 team:read-bereik | Voeg het bereik toe aan je sleutel of genereer een nieuwe met een preset die dit bereik bevat |
422 | Ongeldige queryparameter (bijvoorbeeld een onbekend sort-veld) | Corrigeer de parameter volgens de bovenstaande tabel |
Beveiliging
Dit endpoint is ontworpen om teamlidgegevens veilig beschikbaar te stellen voor publieke weergave. Het antwoord bevat uitsluitend de hierboven beschreven velden. Wachtwoorden, authenticatietokens, accountvergrendelingsgegevens, inloggeschiedenis, tijdzone-/taalvoorkeuren en dienstverbandstatus worden nooit meegestuurd. Het veld id is het gebruikers-ID van het teamlid in Recruitsome. Dit wordt bewust getoond, zodat je het detail-endpoint kunt aanroepen.