Teams
Een team is de centrale eenheid in Payit. Alle activiteiten, producten en inschrijvingen zijn gekoppeld aan een team. Als teamowner kun je ook andere gebruikers uitnodigen.
Alle teams ophalen
GET /api/v1/teams β π authenticatie vereist
Geeft een gepagineerde lijst van alle teams waarvan de ingelogde gebruiker lid is.
Queryparameters
| Parameter | Type | Omschrijving |
|---|---|---|
name |
string | Filter op teamnaam (gedeeltelijke overeenkomst) |
page |
integer | Paginanummer (standaard: 1) |
Voorbeeld
curl -X GET "https://app.payit.be/api/v1/teams?name=club" \
-H "Authorization: Bearer <access_token>"
Respons 200 OK
{
"results": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Mijn Club VZW",
"slug": "mijn-club-vzw",
"email": "[email protected]",
"role": "admin",
"created_at": "2026-01-15T09:00:00.000000Z",
"updated_at": "2026-01-15T09:00:00.000000Z"
}
],
"pagination": {
"current_page": 1,
"last_page": 1,
"per_page": 15,
"total": 1
}
}
Nieuw team aanmaken
POST /api/v1/teams β π authenticatie vereist
Maak een extra team aan (naast je persoonlijke team). De ingelogde gebruiker wordt automatisch eigenaar.
Request body
| Veld | Type | Verplicht | Omschrijving |
|---|---|---|---|
name |
string | β | Naam van het team |
email |
string | Β | Contacte-mail van het team |
vat_number |
string | Β | BTW-nummer |
street |
string | Β | Straat en huisnummer |
zip_code |
string | Β | Postcode |
city |
string | Β | Gemeente |
Voorbeeld
curl -X POST https://app.payit.be/api/v1/teams \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{
"name": "Sportclub Noord",
"email": "[email protected]",
"vat_number": "BE0123456789",
"city": "Gent"
}'
Respons 201 Created
{
"id": "661f9500-f39c-52e5-b827-557766551111",
"name": "Sportclub Noord",
"slug": "sportclub-noord",
"email": "[email protected]",
"role": "admin",
"vat_number": "BE0123456789",
"street": null,
"zip_code": null,
"city": "Gent",
"subscription": "pay-as-use",
"payment_provider": null,
"created_at": "2026-03-01T10:00:00.000000Z",
"updated_at": "2026-03-01T10:00:00.000000Z"
}
Team ophalen
GET /api/v1/teams/{team} β π authenticatie vereist
Geeft de volledige details van een specifiek team. Je moet lid zijn van het team.
Voorbeeld
curl -X GET https://app.payit.be/api/v1/teams/550e8400-e29b-41d4-a716-446655440000 \
-H "Authorization: Bearer <access_token>"
Respons 200 OK
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Mijn Club VZW",
"slug": "mijn-club-vzw",
"email": "[email protected]",
"role": "admin",
"vat_number": "BE0987654321",
"street": "Kerkstraat 10",
"zip_code": "9000",
"city": "Gent",
"subscription": "elite",
"payment_provider": "stripe",
"certificate_type": "vzw",
"certificate_name": "Mijn Club VZW",
"certificate_vat_number": "BE0987654321",
"certificate_street": "Kerkstraat 10",
"certificate_zip_code": "9000",
"certificate_city": "Gent",
"created_at": "2026-01-15T09:00:00.000000Z",
"updated_at": "2026-02-20T14:30:00.000000Z"
}
Team bijwerken
PATCH /api/v1/teams/{team} β π authenticatie vereist
Pas de gegevens van een team bij. Je moet lid zijn van het team. Stuur alleen de velden mee die je wilt wijzigen.
Request body (alle velden optioneel)
| Veld | Type | Omschrijving |
|---|---|---|
name |
string | Naam van het team |
email |
string | Contacte-mail |
vat_number |
string | BTW-nummer |
street |
string | Straat en huisnummer |
zip_code |
string | Postcode |
city |
string | Gemeente |
certificate_type |
string | Type organisatie (bijv. vzw) |
certificate_name |
string | OfficiΓ«le naam voor certificaten |
certificate_vat_number |
string | BTW-nummer voor certificaten |
certificate_street |
string | Adres voor certificaten |
certificate_zip_code |
string | Postcode voor certificaten |
certificate_city |
string | Gemeente voor certificaten |
Voorbeeld
curl -X PATCH https://app.payit.be/api/v1/teams/550e8400-e29b-41d4-a716-446655440000 \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{
"name": "Mijn Club VZW (bijgewerkt)",
"city": "Brussel"
}'
Respons 200 OK
Geeft het volledige bijgewerkte teamobject terug (zelfde structuur als GET).
Gebruiker toevoegen of uitnodigen
POST /api/v1/teams/{team}/users β π authenticatie vereist (alleen teamowner)
Voeg een bestaande Payit-gebruiker toe aan het team, of stuur een uitnodiging naar een onbekend e-mailadres.
- Bestaand account β gebruiker wordt direct toegevoegd (
status: "added") - Onbekend e-mailadres β uitnodigingsmail wordt verstuurd (
status: "invited")
Request body
| Veld | Type | Verplicht | Omschrijving |
|---|---|---|---|
email |
string | β | E-mailadres van de toe te voegen persoon |
role |
string | β | Rol: admin, employee, reader of scanner |
Rollen
| Rol | Rechten |
|---|---|
admin |
Volledig beheer van het team en activiteiten |
employee |
Activiteiten en inschrijvingen bekijken en bewerken |
reader |
Alleen lezen |
scanner |
Alleen tickets scannen |
Voorbeeld β bestaande gebruiker
curl -X POST https://app.payit.be/api/v1/teams/550e8400-e29b-41d4-a716-446655440000/users \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"role": "employee"
}'
Respons 201 Created β gebruiker toegevoegd
{
"id": "7b2c3d4e-5f6a-7890-bcde-f01234567890",
"email": "[email protected]",
"first_name": "Marie",
"last_name": "Peeters",
"role": "employee",
"status": "added"
}
Respons 201 Created β uitnodiging verstuurd
{
"email": "[email protected]",
"role": "reader",
"status": "invited"
}
Foutgevallen
| Status | Oorzaak |
|---|---|
403 |
Je bent geen eigenaar van dit team |
422 |
Gebruiker is al lid, of uitnodiging bestaat al |