Skip to main content

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