Bijgewerkt 22 april 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();Teamleden ophalen
Haal een gepagineerde lijst op van actieve teamleden. Ideaal om je team op je website te tonen.
Endpoint
GET /api/v1/team
Standaard filtering
Dit endpoint retourneert alleen momenteel in dienst zijnde interne teamleden. Voormalige medewerkers en externe portalgebruikers worden automatisch uitgesloten.
Query Parameters
| 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 match) |
role | string | - | Filter op rolnaam (bijv. administrator, hr_manager) |
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 meesturen |
include_role | boolean | false | Rollabel meesturen |
Responsevelden
| Veld | Type | Beschrijving | |
|---|---|---|---|
id | integer | Uniek teamlid-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 (alleen wanneer include_phone=true) |
avatar | object | Avatar-afbeeldings-URL's in meerdere formaten | |
role | string\ | null | Rollabel (alleen wanneer include_role=true) |
Avatar-object
Avatarafbeeldingen worden in drie formaten aangeboden. Retourneert null voor elk formaat als er geen avatar is geüpload.
{
"small": "https://...",
"medium": "https://...",
"large": "https://..."
}
| Formaat | Afmetingen | Toepassing |
|---|---|---|
small | 128x128 | Lijsten, kaarten |
medium | 256x256 | Profielsecties, headers |
large | 512x512 | Volledige profielweergaven |
Voorbeeldverzoek
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"
Voorbeeldrespons
{
"data": [
{
"id": 1,
"given_name": "Jane",
"family_name": "Doe",
"full_name": "Jane Doe",
"job_title": "HR Manager",
"email": "[email protected]",
"avatar": {
"small": "https://storage.example.com/avatars/1/small.jpg",
"medium": "https://storage.example.com/avatars/1/medium.jpg",
"large": "https://storage.example.com/avatars/1/large.jpg"
},
"role": "HR Manager"
}
],
"links": {
"first": "...?page=1",
"last": "...?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"per_page": 20,
"to": 1,
"total": 1
}
}
Beveiliging
Dit endpoint is ontworpen om teamlidgegevens veilig beschikbaar te stellen voor publieke weergave. De volgende gevoelige velden worden nooit opgenomen in de respons:
- Wachtwoorden en authenticatietokens
- Accountvergrendelingsgegevens
- Inloggeschiedenis
- Interne systeem-ID's
- Tijdzone- en taalvoorkeuren
- Dienstverbandstatus (wordt alleen gebruikt voor filtering)