Veldspecificaties

56 items
Path Naam Type Verplicht Beperkingen
request.body
body
Object Nee - Bewerken
request.body.school
school

A reference to a School organisation.

Object Ja - Bewerken
request.body.school.organisationIds
organisationIds

A secondary identifier for the School. This value is used whenever the primary identifier is not available. (either organisationMasterIdentifier or organisationIds is required)

Lijst[] Nee - Bewerken
request.body.school.organisationIds[*]
organisationIds

A secondary identifier for the School. This value is used whenever the primary identifier is not available. (either organisationMasterIdentifier or organisationIds is required)

Object Nee - Bewerken
request.body.school.organisationIds[*].organisationId
organisationId
Tekenreeks Ja - Bewerken
request.body.school.organisationIds[*].organisationIdType
organisationIdType
Keuzelijst Ja toegestaan ["OIE_CODE","BP_ID","DD_ID","AS_ID","V_ID"] Bewerken
request.body.school.organisationMasterIdentifier
organisationMasterIdentifier

The primary identifier for a School. For Schools the OnderwijsaanbiederId is used. (either organisationMasterIdentifier or organisationIds is required)

Tekenreeks Nee - Bewerken
request.body.student
student
Object Ja - Bewerken
request.body.student.userIds
userIds

A secondary identifier for a User. This value is used whenever the primary identifier is not available. For Employees this value is mandatory. (either userMasterIdentifier or userIds is required)

Lijst[] Nee - Bewerken
request.body.student.userIds[*]
userIds

A secondary identifier for a User. This value is used whenever the primary identifier is not available. For Employees this value is mandatory. (either userMasterIdentifier or userIds is required)

Object Nee - Bewerken
request.body.student.userIds[*].userId
userId
Tekenreeks Ja - Bewerken
request.body.student.userIds[*].userIdType
userIdType
Keuzelijst Ja toegestaan ["NEPPI","BPI","eduID","NEPRI","ASI","eckId"] Bewerken
request.body.student.userMasterIdentifier
userMasterIdentifier

The primary identifier for a User. For Students the ECK iD is used. For Employees this value is empty. There is no primary identifier for Employees. (either userMasterIdentifier or userIds is required)

Tekenreeks Nee - Bewerken
request.query.enrollmentType
enrollmentType

Optional filter to request all Enrollment objects for a specified enrollmentType.

Keuzelijst Nee toegestaan ["study","subject"] Bewerken
request.query.schoolPeriodId
schoolPeriodId

Optional filter to request all Enrollment objects within a specified SchoolPeriod and its corresponding schoolPeriodId.

Tekenreeks Nee - Bewerken
request.query.studyOfferingId
studyOfferingId

Optional filter to request all Enrollment objects into a StudyOffering and its corresponding studyOfferingId.

Tekenreeks Nee - Bewerken
request.query.subjectOfferingId
subjectOfferingId

Optional filter to request all Enrollment objects into a SubjectOffering and its corresponding subjectOfferingId.

Tekenreeks Nee - Bewerken
response.200
response 200

OK

Lijst[] Nee - Bewerken
response.200[*]
response 200

The Enrollment object for a student into a StudyYear or SubjectOffering for a SchoolPeriod.

Object Nee - Bewerken
response.200[*].beginDate
beginDate

The start date on which the enrollment becomes active (inclusive). Format: YYYY-MM-DD (according to RFC3339).

Datum Ja - Bewerken
response.200[*].dateCreated
dateCreated

Indicates the date and time the object was first created. Format: According to openapi in ZULU time as specified in RFC 3339, section 5.6.

Datum/tijd Ja - Bewerken
response.200[*].dateLastModified
dateLastModified

Indicates the date and time the object was last modified. Format: According to openapi in ZULU time as specified in RFC 3339, section 5.6.

Datum/tijd Ja - Bewerken
response.200[*].endDate
endDate

The end date on which the enrollment becomes inactive (exclusive). Format: YYYY-MM-DD (according to RFC3339).

Datum Nee - Bewerken
response.200[*].enrollmentId
enrollmentId

A unique identifier for this Enrollment object. This is the GUID that Consumers will refer to when making API calls, or when needing to identify an object.

UUID Ja - Bewerken
response.200[*].enrollmentType
enrollmentType

The type of enrollment, being one of:

  • study: an enrollment into a StudyOffering offered by the School.
  • subject: an enrollment into a SubjectOffering offered by the School.
Keuzelijst Ja toegestaan ["study","subject"] Bewerken
response.200[*].location
location

A reference to a Location of a School.

Object Nee - Bewerken
response.200[*].location.locationIds
locationIds

A secondary identifier for the Location. For Locations the Vestigingserkenning aka VE_CODE is used. This value is used whenever the primary identifier is not available. (either locationMasterIdentifier or locationIds is required)

Lijst[] Nee - Bewerken
response.200[*].location.locationIds[*]
locationIds

A secondary identifier for the Location. For Locations the Vestigingserkenning aka VE_CODE is used. This value is used whenever the primary identifier is not available. (either locationMasterIdentifier or locationIds is required)

Object Nee - Bewerken
response.200[*].location.locationIds[*].locationId
locationId
Tekenreeks Ja - Bewerken
response.200[*].location.locationIds[*].locationIdType
locationIdType
Keuzelijst Ja toegestaan ["VE_CODE"] Bewerken
response.200[*].location.locationMasterIdentifier
locationMasterIdentifier

The primary identifier for a Location. For Locations the Onderwijslocatie aka OL_CODE is used. (either locationMasterIdentifier or locationIds is required)

Tekenreeks Nee - Bewerken
response.200[*].location.name
name

A name for the Location.

Tekenreeks Ja - Bewerken
response.200[*].schoolPeriod
schoolPeriod

A reference to the schoolPeriodId of the SchoolPeriod where this enrollment is part of.

Tekenreeks Ja - Bewerken
response.200[*].status
status

The status field gives an indication to Consumers about the status of an object. Consumers can delete objects that are flagged tobedeleted as such if they wish.

The status attribute is based on the Base Class from OneRoster.

Keuzelijst Ja toegestaan ["active","tobedeleted"] Bewerken
response.200[*].student
student

The Student to which this enrollment object belongs.

Object Ja - Bewerken
response.200[*].student.userIds
userIds

A secondary identifier for a User. This value is used whenever the primary identifier is not available. For Employees this value is mandatory. (either userMasterIdentifier or userIds is required)

Lijst[] Nee - Bewerken
response.200[*].student.userIds[*]
userIds

A secondary identifier for a User. This value is used whenever the primary identifier is not available. For Employees this value is mandatory. (either userMasterIdentifier or userIds is required)

Object Nee - Bewerken
response.200[*].student.userIds[*].userId
userId
Tekenreeks Ja - Bewerken
response.200[*].student.userIds[*].userIdType
userIdType
Keuzelijst Ja toegestaan ["NEPPI","BPI","eduID","NEPRI","ASI","eckId"] Bewerken
response.200[*].student.userMasterIdentifier
userMasterIdentifier

The primary identifier for a User. For Students the ECK iD is used. For Employees this value is empty. There is no primary identifier for Employees. (either userMasterIdentifier or userIds is required)

Tekenreeks Nee - Bewerken
response.200[*].study
study

A reference to the studyOfferingId of the StudyOffering in case this enrollment is of the enrollmentType study.

UUID Nee - Bewerken
response.200[*].studyPublicId
studyPublicId

A reference to the public id of the StudyOffering in RIO in case this enrollment is of the enrollmentType study

UUID Nee - Bewerken
response.200[*].studyYear
studyYear

The study year of this object in case the enrollment is of the enrollmentType 'study'

Example values are:

  • Basisschool: 0, 1, 2, 3, 4, 5, 6, 7 or 8
  • VMBO: 1, 2, 3 or 4
  • HAVO: 1, 2, 3, 4 or 5
  • VWO: 1, 2, 3, 4, 5 or 6
Geheel getal Nee - Bewerken
response.200[*].subject
subject

A reference to the subjectOfferingId of the SubjectOffering in case this enrollment is of the enrollmentType subject.

UUID Nee - Bewerken
response.400
response 400

Functional status code and status message.

Object Nee - Bewerken
response.400.status
status

See functional status codes within the Documentation.

Geheel getal Ja - Bewerken
response.400.statusMessage
statusMessage

See functional status messages within the Documentation.

Tekenreeks Nee - Bewerken
response.401
response 401

Functional status code and status message.

Object Nee - Bewerken
response.401.status
status

See functional status codes within the Documentation.

Geheel getal Ja - Bewerken
response.401.statusMessage
statusMessage

See functional status messages within the Documentation.

Tekenreeks Nee - Bewerken
response.403
response 403

Functional status code and status message.

Object Nee - Bewerken
response.403.status
status

See functional status codes within the Documentation.

Geheel getal Ja - Bewerken
response.403.statusMessage
statusMessage

See functional status messages within the Documentation.

Tekenreeks Nee - Bewerken
response.404
response 404

Functional status code and status message.

Object Nee - Bewerken
response.404.status
status

See functional status codes within the Documentation.

Geheel getal Ja - Bewerken
response.404.statusMessage
statusMessage

See functional status messages within the Documentation.

Tekenreeks Nee - Bewerken

Verwachte statuscodes

5 items
Code Betekenis Uitkomst
200 OK Succes Bewerken
400 Bad Request Fout Bewerken
401 Unauthorized Fout Bewerken
403 Forbidden Fout Bewerken
404 Not Found Fout Bewerken