createEnrollment: Create Abbreviated Enrollment Record
This API is used to create a person, their application, Student and Financial Aid (promise grant) information at the Teaching College.
Document Status complete
API Name
/createEnrollment
Method
POST
Version
1.4.0.xxx
Request Headers
Key | Value | Description | Required |
---|---|---|---|
|
| Unique value to identify the client location. | Yes |
|
| Illuminate Auth token | Yes |
|
| The | Yes |
|
| Unique key assigned for a consumer for each client location | Yes |
|
| Unique tracer Id that belongs to the consumer. | Optional |
Default Illuminate Authorization works for any API that is created in the Illuminate platform. If any other authorization is opted, it is required that it is set up and upon using the API, a proper token is required depending on the authentication choice made.
Input Params
N/A
Request Body
field | type | description | example | comments |
|
| CCCID of the Student |
| Required. Accepts any CCCID (even if it does not exist) |
|
| Information about the student |
| Required |
|
| Information about the student’s demographics |
| Optional |
|
| First name of the student |
| Required |
|
| Last name of the student |
| Required |
|
| Middle name |
| Optional |
|
| Students date of birth | e.g. | ISO_8601 date format(Required) |
|
| Array of email address objects |
| Optional, If an email is sent - |
|
| Email address of the students |
| Optional |
|
| Array of phone number objects |
| Optional, If a phone is sent - Number format = |
|
| Student’s phone number |
| Optional |
|
| Array of address objects |
| Optional, If an address is sent |
|
| Street line 1 of the address |
| Optional |
|
| Street line 2 of the address |
| Optional |
|
| City |
| Optional |
|
| State | e.g. | Optional |
|
| Zip code |
| Optional |
|
| Country | e.g. | Optional |
|
| Campus code |
| Required |
|
| Term to which the student enrollment is being processed |
| Required |
|
| In / Out state status of the student |
| Required |
|
| Y if In-State, N if Out-of-State |
| Required |
|
|
|
| Required |
|
| Promise grant available indicator (Y: has Promise grant, N - No Promise grant) |
| Optional |
|
| Y or N |
| Optional |
|
|
|
| Required |
|
| Information about the student’s home college |
| Required |
|
| Home college FICECode |
| Required |
|
| Home college MIS college code |
| Required |
|
| Name of the college |
| Required |
|
| Canvas root account |
| Required |
|
| User ID for SIS |
| Required |
|
| Canvas Login ID |
| Required |
Below is the schema for the request body
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"cccId": {
"type": "string"
},
"studentDetails": {
"type": "object",
"properties": {
"demographicInfo": {
"type": "object",
"properties": {
"firstName": {
"type": "string"
},
"lastName": {
"type": "string"
},
"middleName": {
"type": "string"
},
"dateOfBirth": {
"type": "string"
},
"emails": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"address": {
"type": "string"
}
},
"required": [
"address"
]
}
]
},
"phones": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"number": {
"type": "string"
}
},
"required": [
"number"
]
}
]
},
"addresses": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"StreetLine1": {
"type": "string"
},
"StreetLine2": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"Zip": {
"type": "string"
},
"Country": {
"type": "string"
}
},
"required": [
"StreetLine1",
"city",
"state",
"Zip",
"Country"
]
}
]
}
},
"required": [
"firstName",
"lastName",
"addresses"
]
},
"campusCode": {
"type": "string"
},
"termCode": {
"type": "string"
},
"residency": {
"type": "object",
"properties": {
"residencyValue": {
"type": "string"
},
"source": {
"type": "string"
}
},
"required": [
"residencyValue",
"source"
]
},
"promiseGrant": {
"type": "object",
"properties": {
"promiseGrantValue": {
"type": "string"
},
"source": {
"type": "string"
}
},
"required": [
"promiseGrantValue",
"source"
]
},
"homeCollegeInfo": {
"type": "object",
"properties": {
"FICECode": {
"type": "string"
},
"MISCode": {
"type": "string"
},
"collegeName": {
"type": "string"
},
"canvasRootAccount": {
"type": "string"
},
"sisUserId": {
"type": "string"
},
"canvasLoginId": {
"type": "string"
}
},
"required": [
"FICECode",
"MISCode",
"collegeName",
"canvasRootAccount",
"sisUserId",
"canvasLoginId"
]
}
},
"required": [
"campusCode",
"termCode",
"residency",
"promiseGrant",
"homeCollegeInfo"
]
}
},
"required": [
"cccId",
"studentDetails"
]
} |
Response Headers
Key | Value | Description |
---|---|---|
|
| Illuminate API request unique tracing Id |
|
| Requested API version |
|
| Unique tracer Id that belongs to the consumer. This will be returned only if the value is passed through Request Headers. |
Response Body
field | type | description | example | comments |
|
| Status of the API call
|
| This is the status of the API. Status response is case-insensitive. |
|
| Success message or relevant message |
|
|
Schema: 200 OK
Below is the schema for the request body
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"status": {
"type": "string"
},
"response": {
"type": "string"
}
},
"required": [
"status",
"response"
]
} |
Schema: 401 Unauthorized
Schema: 406 Not Acceptable
Schema: 412 Precondition Failed
Schema: 5xx Server Errors
Possible Messages
The following are the error messages. The list is limited to Illuminate messages and doesn’t cover the SIS specific messages.
Code | Status | Message |
---|---|---|
|
| success |
|
| Authorization info missing |
|
| companyID is missing |
|
| Illuminate API key is missing |
|
| Invalid API Name |
|
| Invalid API Key |
|
| Missing required input fields |
|
| Internal error encountered |
|
| Bad Gateway |
|
| Service Unavailable |
|
| Gateway Timeout |
Audit Log
May 13, 2020
Accelerated plan changes implemented
May 26, 2020
Removed
dateOfBirth
from the request body
Jun 1, 2020
Changed
campus
tocampusCode
in the request body
Jun 12, 2020
Added
residencyValue
,source
,promiseGrantValue
,source
,homeCollegeInfo
,FICECode
,MISCode
,collegeName
,canvasRootAccount
, andsisUserId
to the request bodyRemoved fields related to
homecollegelmsurl
from the request bodyUpdated version number
Jun 16, 2020
Added
canvasLoginId
to the request body
Jun 22, 2020
Updated accepted values for
residency.source
andpromiseGrant.source
Dec 1, 2020
Added
dateOfBirth
to the request body