DPA API

De DPA (Data Processing Agreement) API maakt het mogelijk om te verifiëren of er een geldige verwerkersovereenkomst bestaat tussen een leverancier en een onderwijsbestuur binnen het Edu-V Afsprakenstelsel.

Status: Beta — Implementation Draft (v0.9.1). Zie de EDU-V documentatie voor DPA API.

Wanneer is een verwerkersovereenkomst nodig?

Een verwerkersovereenkomst (verwerkersregister) is vereist wanneer een leverancier als verwerker optreedt voor persoonsgegevens van een onderwijsorganisatie. Het Consentmanagement-component kan de DPA API raadplegen om te controleren of een overeenkomst geldig is alvorens consent te verlenen.

Scope: eduv.dpa

Het Agreement-model

Name
agreementId
Type
string
Description
Unieke referentie van de verwerkersovereenkomst.
Name
supplierOin
Type
string
Description
OIN van de leverancier.
Name
boardId
Type
string
Description
Administratienummer van het schoolbestuur.
Name
ecosystem
Type
string
Description
Ketensamenwerkingsverband, bijv. Edu-V.
Name
dataServices
Type
array[string]
Description
Gegevensdiensten: Onderwijsaanbod, Onderwijsinrichting, Onderwijsdeelnemers, etc.
Name
valid
Type
boolean
Description
Of de overeenkomst geldig is.
Name
startDate
Type
date
Description
Ingangsdatum.
Name
endDate
Type
date
Description
Einddatum.

GET/edu-v/v1/dpa-api/agreements

Verwerkersovereenkomst ophalen

Haal de verwerkersovereenkomst op voor een specifiek schoolbestuur.

Response (200)

{
    "agreementId": "AGR-2026-001",
    "supplierOin": "00000004123456789000",
    "boardId": "99XX",
    "ecosystem": "Edu-V",
    "dataServices": ["Onderwijsaanbod", "Onderwijsdeelnemers"],
    "valid": true,
    "startDate": "2026-01-01",
    "endDate": "2027-12-31"
}

Foutresponses

Zie EDU-V Foutcodes — DPA API (11xx) voor het volledige overzicht van functionele foutcodes.