Student Profile API
Description
This API call responds with a student profile as well as any activity of that student including course attendance and appointments.
Endpoint Specification
Path: api/students/:user_id/student_profile
Method: GET
Parameters:
Parameter Name | Definition |
user_id | (string) user primary id |
Template API Call using cURL
curl -u <YourAPIUSername>:<YourAPIKey> https://<yourschoolsubdomain>.gradesfirst.com/api/students/:user_id/student_profile
Example API Call using cURL
curl -u vendor@school.edu:ebd6b6470d35d12675fcbd308125b7 https://coastalcollege.gradesfirst.com/api/students/13221/student_profile
Output
This call outputs a JSON array.
Attribute Name | Definition |
success | (boolean) true or false value whether the method was returned successfully |
transaction_id | (string) globally unique identifier for this API request |
student: address_1 | (string) First line of the student's address |
student: address_2 | (string) Second line of the student's address |
student: alternate_id | (string) The student's Alternate ID in GradesFirst |
student: cell_phone | (string) The student's cell phone number |
student: city | (string) City of the student's address |
student: created_at | (datetime) Date and time when this student record was first created in GradesFirst |
student: classification | (string) The student's academic classification (Freshman, Sophomore, Junior, Senior) |
student: date_of_birth | (date) The student's date of birth |
student: email | (string) The student's email address |
student: enrollment_goal | (string) The student's enrollment goal |
student: enrollment_status | (string) The student's enrollment status |
student: ethnicity | (string) The student's ethnicity |
student: first_name | (string) The student's first name |
student: gender | (string) The student's gender |
student: home_phone | (string) The student's home phone number |
student: id | (integer) The student's GradesFirst system ID. |
student: is_active | (boolean) The student's active status. |
student: is_at_risk | (boolean) The student's at-risk status (as set on their profile) |
student: last_name | (string) The student's last name |
student: login | (string) The student's GradesFirst login (username) |
student: primary_id | (string) The student's primary ID in GradesFirst |
student: sso_id | (string) The student's Single Sign-On ID |
student: state | (string) The state of the student's address |
student: url | (string) The URL for the student’s profile page in GradesFirst |
student: work_phone | (string) The student's work phone number |
student: zip | (string) The zip code of the student's address |
courses | (array[course]) An array representing the student's courses for the current term |
activity: recent_appointments | (array[appointment]) An array representing the student's recent appointments within the last month. |
activity: next_appointments | (array[appointment]) An array representing the student's upcoming appointments |
activity: recent_notes | (array[note]) An array representing the student's 10 most recently created or updated notes |
Appointment | DataType |
location | (string) location of appointment |
datetime | (datetime) The date and time of the appointment |
organizer: name | (string) The name of the organizer of the appointment |
organizer: primary_id | (string) The Primary ID of the organizer in GradesFirst |
type | (string) type of appointment (e.g. Advising, Tutoring) |
Course | DataType |
name | (string) name of course |
section_name | (string) name of section |
unexcused_absences | (int) number of the student's unexcused absences in this course |
at_risk_progress_reports | (int) number of the student's at-risk progress reports in this course |
Note | DataType |
updated_at | (datetime) The date and time the note was created or last updated |
reasons | (string) A comma-delimited list of the note reasons for the note |
body | (string) The content of the note |
Output Example
{
"student": {
"address_1": "101 Main Street",
"address_2": "Apt 12",
"alternate_id": "012345",
"cell_phone": "999-999-9999",
"city": "Littletown",
"created_at": "2014-11-30T23:59:59-06:00",
"current_classification": "Junior",
"date_of_birth": "01/01/1980",
"email": "john.doe@example.com",
"enrollment_goal": "Graduation",
"enrollment_status": "On Track",
"ethnicity": "",
"gender": "Male",
"primary_id": "543210",
"first_name": "John",
"home_phone": "999-999-9999",
"id": 12345,
"is_active": true,
"is_at_risk": false,
"last_name": "Doe",
"login": "john.doe",
"sso_id": "john.doe@schoolexample.edu",
"state": "PA",
"url": "https://coastalcollege.gradesfirst.com/users/12345-john_doe",
"work_phone": "999-999-9999",
"zip": "12345",
},
"success": true,
"transaction_id":"1234567890",
"courses": [
{
"name": "MATH110 - Mathematics",
"section_name": "A01",
"unexcused_absences": 4,
"at_risk_progress_reports": 2
},
{
"name": "ENGL201 - World Literature",
"section_name": "B21",
"unexcused_absences": 2,
"at_risk_progress_reports": 1
}
],
"activity": {
"next_appointments": [
{
"location": "Conference Room 3",
"datetime": "2014-09-10T16:03:48-06:00",
"organizer": {
"name": "Bob Smith",
"primary_id": "12346"
},
"type": "Advising"
},
{
"location": "Math Lab",
"datetime": "2014-09-10T16:03:48-06:00",
"organizer": {
"name": "Joe Green",
"primary_id": "12347"
},
"type": "Tutoring"
}
],
"recent_appointments": [
{
"location": "Conference Room 3",
"datetime": "2014-11-10T16:03:48-06:00",
"organizer": {
"name": "Bob Smith",
"primary_id": "12346"
},
"type": "Advising"
},
{
"location": "Math Lab",
"datetime": "2014-11-10T16:03:48-06:00",
"organizer": {
"name": "Joe Green",
"primary_id": "12347"
},
"type": "Tutoring"
}
],
"recent_notes":[
{
"updated_at":"2014-11-01T00:00:00-05:00",
"reasons":"Advising, Academic Plan",
"body":"This is Joe's academic plan."
},
{
"updated_at":"2014-11-01T00:00:00-05:00",
"reasons":"Advising, Registration",
"body":"This is a note about registration."
}
]
}
}