/enrollments/school/student - Association (P)

Veldspecificaties

54 items

Veld	Beschrijving	Type	Verplicht	Beperkingen
`request.query.enrollmentType`	enrollmentType	Keuzelijst	Nee	-
`request.query.schoolPeriodId`	schoolPeriodId	Tekenreeks	Nee	-
`request.query.studyOfferingId`	studyOfferingId	Tekenreeks	Nee	-
`request.query.subjectOfferingId`	subjectOfferingId	Tekenreeks	Nee	-
`response.`	response A reference to a School organisation.	Object	Nee	-
`response..organisationMasterIdentifier`	organisationMasterIdentifier The primary identifier for a School. For Schools the `OnderwijsaanbiederId` is used. (either organisationMasterIdentifier or organisationIds is required)	Tekenreeks	Nee	-
`response..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	-
`response..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	-
`response..organisationIds[*].organisationId`	organisationId	Tekenreeks	Ja	-
`response..organisationIds[*].organisationIdType`	organisationIdType	Keuzelijst	Ja	toegestaan ["OIE_CODE","BP_ID","DD_ID","AS_ID","V_ID"]
`response.`	response	Object	Nee	-
`response..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	-
`response..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	-
`response..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	-
`response..userIds[*].userId`	userId	Tekenreeks	Ja	-
`response..userIds[*].userIdType`	userIdType	Keuzelijst	Ja	toegestaan ["NEPPI","BPI","eduID","NEPRI","ASI","eckId"]
`response.200`	response 200 The Enrollment object for a student into a StudyYear or SubjectOffering for a SchoolPeriod.	Object	Nee	-
`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.	Tekenreeks	Ja	-
`response.200.student`	student The Student to which this enrollment object belongs.	Object	Ja	UserReference
`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	-
`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	-
`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	-
`response.200.student.userIds[*].userId`	userId	Tekenreeks	Ja	-
`response.200.student.userIds[*].userIdType`	userIdType	Keuzelijst	Ja	toegestaan ["NEPPI","BPI","eduID","NEPRI","ASI","eckId"]
`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"]
`response.200.study`	study A reference to the studyOfferingId of the StudyOffering in case this enrollment is of the enrollmentType `study`.	Tekenreeks	Nee	-
`response.200.studyPublicId`	studyPublicId A reference to the public id of the StudyOffering in RIO in case this enrollment is of the enrollmentType `study`	Tekenreeks	Nee	-
`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	-
`response.200.location`	location The Location to which this enrollment object belongs.	Object	Nee	LocationReference
`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	-
`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	-
`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	-
`response.200.location.locationIds[*].locationId`	locationId	Tekenreeks	Ja	-
`response.200.location.locationIds[*].locationIdType`	locationIdType	Keuzelijst	Ja	toegestaan ["VE_CODE"]
`response.200.location.name`	name A name for the Location.	Tekenreeks	Ja	-
`response.200.subject`	subject A reference to the subjectOfferingId of the SubjectOffering in case this enrollment is of the enrollmentType `subject`.	Tekenreeks	Nee	-
`response.200.schoolPeriod`	schoolPeriod A reference to the schoolPeriodId of the SchoolPeriod where this enrollment is part of.	Tekenreeks	Ja	-
`response.200.beginDate`	beginDate The start date on which the enrollment becomes active (inclusive). Format: YYYY-MM-DD (according to RFC3339).	Datum	Ja	-
`response.200.endDate`	endDate The end date on which the enrollment becomes inactive (exclusive). Format: YYYY-MM-DD (according to RFC3339).	Datum	Nee	-
`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 ["study","subject"]
`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	-
`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	-
`response.400`	response 400 Functional status code and status message.	Object	Nee	-
`response.400.status`	status See functional status codes within the Documentation.	Geheel getal	Ja	-
`response.400.statusMessage`	statusMessage See functional status messages within the Documentation.	Tekenreeks	Nee	-
`response.401`	response 401 Functional status code and status message.	Object	Nee	-
`response.401.status`	status See functional status codes within the Documentation.	Geheel getal	Ja	-
`response.401.statusMessage`	statusMessage See functional status messages within the Documentation.	Tekenreeks	Nee	-
`response.403`	response 403 Functional status code and status message.	Object	Nee	-
`response.403.status`	status See functional status codes within the Documentation.	Geheel getal	Ja	-
`response.403.statusMessage`	statusMessage See functional status messages within the Documentation.	Tekenreeks	Nee	-
`response.404`	response 404 Functional status code and status message.	Object	Nee	-
`response.404.status`	status See functional status codes within the Documentation.	Geheel getal	Ja	-
`response.404.statusMessage`	statusMessage See functional status messages within the Documentation.	Tekenreeks	Nee	-

Verwachte statuscodes

5 items

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

Bronspecificatie (YAML)

Ruwe definitie uit het afsprakenstelsel.

  /enrollments/school/student:
    parameters:
      - schema:
          type: string
          enum:
            - study
            - subject
        name: enrollmentType
        in: query
        required: false
        description: 'Optional filter to request all Enrollment objects for a specified enrollmentType.'
      - schema:
          type: string
        name: schoolPeriodId
        in: query
        required: false
        description: 'Optional filter to request all Enrollment objects within a specified SchoolPeriod and its corresponding schoolPeriodId.'
      - schema:
          type: string
        name: studyOfferingId
        in: query
        required: false
        description: 'Optional filter to request all Enrollment objects into a StudyOffering and its corresponding studyOfferingId.'
      - schema:
          type: string
        name: subjectOfferingId
        in: query
        required: false
        description: 'Optional filter to request all Enrollment objects into a SubjectOffering and its corresponding subjectOfferingId.'
    post:
      summary: Get Enrollments for Student at School
      x-tags:
        - Enrollment
      tags:
        - Administratiesysteem onderwijsdeelnemer
      operationId: get-enrollments-for-student-at-school
      description: 'Request Enrollment objects for a specified Student at a School.'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                school:
                  $ref: '#/components/schemas/SchoolReference'
                student:
                  $ref: '#/components/schemas/UserReference'
              required:
                - school
                - student
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Enrollment'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponse'
      security:
        - OAuth2:
            - eduv.association