/
createEnrollment: Create Abbreviated Enrollment Record

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

Key

Value

Description

Required

companyID

e.g. N2N

Unique value to identify the client location.

Yes

Authorization

e.g. AxasdaAAgfsads==

Illuminate Auth token

Yes

Content-Type

application/json

The Content-Type header is used to indicate the media type of the resource

Yes

illuminateApiKey

String

Unique key assigned for a consumer for each client location

Yes

X-Consumer-Tracer-Id

String

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

string

CCCID of the Student

 

Required. Accepts any CCCID (even if it does not exist)

studentDetails

object

Information about the student

 

Required

demographicInfo

object

Information about the student’s demographics

 

Optional

firstName

string

First name of the student

 

Required

lastName

string

Last name of the student

 

Required

middleName

string

Middle name

 

Optional

dateOfBirth

string

Students date of birth

e.g. YYYY-MM-DD

ISO_8601 date format(Required)

emails

array of objects

Array of email address objects

 

Optional, If an email is sent - emails.[address] is required

address

string

Email address of the students

 

Optional

phones

array of objects

Array of phone number objects

 

Optional, If a phone is sent - phones.[number] is required

Number format = "number": "123-456-7890"

number

string

Student’s phone number

 

Optional

addresses

array of objects

Array of address objects

 

Optional, If an address is sent StreetLine1, city, state, country, zip are required

StreetLine1

string

Street line 1 of the address

 

Optional

StreetLine2

string

Street line 2 of the address

 

Optional

city

string

City

 

Optional

state

string

State

e.g. Georgia

Optional

Zip

string

Zip code

 

Optional

country

string

Country

e.g. USA

Optional

campusCode

string

Campus code

 

Required

termCode

string

Term to which the student enrollment is being processed

 

Required

residency

string

In / Out state status of the student

 

Required

residencyValue

string

Y if In-State, N if Out-of-State

 

Required

source

string

HC if API pulled from HC or if the HC verified. Studentif the student self reports.

 

Required

promiseGrant

string

Promise grant available indicator (Y: has Promise grant, N - No Promise grant)

 

Optional

promiseGrantValue

string

Y or N

 

Optional

source

string

HC if API pulled from HC or if the HC verified. Studentif the student self reports.

 

Required

homeCollegeInfo

string

Information about the student’s home college

 

Required

FICECode

string

Home college FICECode

 

Required

MISCode

string

Home college MIS college code

 

Required

collegeName

string

Name of the college

 

Required

canvasRootAccount

string

Canvas root account

 

Required

sisUserId

string

User ID for SIS

 

Required

canvasLoginId

string

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

Key

Value

Description

X-Tracing-Id

e.g. 8-1589911066.164-10.2.3.2-946-1000914

Illuminate API request unique tracing Id

apiVersion

String

Requested API version

X-Consumer-Tracer-Id

String

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

string

Status of the API call

  • success

  • fail

 

This is the status of the API. Status response is case-insensitive.

response

string

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

Code

Status

Message

200

OK

success

401

Unauthorized

Authorization info missing

401

Unauthorized

companyID is missing

401

Unauthorized

Illuminate API key is missing

412

Precondition Failed

Invalid API Name

412

Precondition Failed

Invalid API Key

412

Precondition Failed

Missing required input fields

500

Internal Server Error

Internal error encountered

502

Bad Gateway

Bad Gateway

502

Service Unavailable

Service Unavailable

504

Gateway Timeout

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 to campusCode in the request body

  • Jun 12, 2020

    • Added residencyValue, source, promiseGrantValue, source, homeCollegeInfo, FICECode, MISCode, collegeName, canvasRootAccount, and sisUserId to the request body

    • Removed fields related to homecollegelmsurl from the request body

    • Updated version number

  • Jun 16, 2020

    • Added canvasLoginId to the request body

  • Jun 22, 2020

    • Updated accepted values for residency.source and promiseGrant.source

  • Dec 1, 2020

    • Added dateOfBirth to the request body

 

Related content

CVC-OEI Technical Documents
CVC-OEI Technical Documents
More like this
Q1 Error Report 2024
Q1 Error Report 2024
More like this
CVC-OEI
CVC-OEI
More like this
Q4 Error Report 2024
Q4 Error Report 2024
More like this
11/13/23 Weekly Status Report
11/13/23 Weekly Status Report
More like this
1/8/24 Weekly Status Report
1/8/24 Weekly Status Report
More like this