Matriculation number

Represents the matriculation number for the applicant.

/api/v9/applicants/ID/matriculation

GET Get a matriculation number

A request with the GET verb returns the JSON-encoded matriculation number for this applicant. Note that the value appears to be a double-quoted value, but is a JSON string literal in the strict sense. If there is no matriculation number, null is returned.

GET /api/v9/applicants/123/matriculation
Host: apply.example.edu
Authorization: DREAM apikey="..."

Example request

curl \
  -X GET \
  -H "Authorization: DREAM apikey=\"YOUR-API-KEY\"" \
  "https://apply.example.edu/api/v9/applicants/123/matriculation"

Response headers

Response codes

Example response

"ABC123"

PUT Set a matriculation number

When making a PUT request, the contents of the request body will be stored as the new matriculation number for the applicant in question.

The body must be a JSON encoded string literal, this means that it has to be double-quoted like "ABC123", not just ABC123. A minimum of 3 and a maximum 16 characters are allowed and the matriculation number can only contain lowercase and uppercase letters, numbers, dots, dashes and slashes.

PUT /api/v9/applicants/123/matriculation
Host: apply.example.edu
Authorization: DREAM apikey="..."

Example request

curl \
  -X PUT \
  -d '"ABC123"' \
  -H "Authorization: DREAM apikey=\"YOUR-API-KEY\"" \
  "https://apply.example.edu/api/v9/applicants/123/matriculation"

Response headers

Response codes