Students
Students are child users who use ManageBac to learn
This endpoint allows to update student's avatar.
Your V2 API authentication token may be passed in the parameters. To protect your key, use environment variables.
Unique identifier for a student.
Success
Bad Request
PUT /v2/students/{id}/avatar HTTP/1.1
Host: api.devel.managebac.com
Content-Type: application/json
Accept: */*
Content-Length: 37
{
"avatar": {
"remote_file_url": "text"
}
}{
"status": "ok"
}This endpoint allows to delete student's avatar.
Your V2 API authentication token may be passed in the parameters. To protect your key, use environment variables.
Unique identifier for a student.
Success
DELETE /v2/students/{id}/avatar HTTP/1.1
Host: api.devel.managebac.com
Accept: */*
Success
{
"status": "ok"
}This endpoint retrieves all students. It returns personal details and program as well as any School-defined values.
Your V2 API authentication token may be passed in the parameters. To protect your key, use environment variables.
Return only records with the given IDs.
Return only archived (1) or only active (0) students. If value is not specified, all students are returned.
Return students by status. Available statuses: enrolled, withdrawn, graduated. If value is not specified, all students are returned.
A timestamp to filter the modification date of results.
An integer list of year group ids to filter by.
An integer list of year group ids to filter by.
An integer list of homeroom advisor ids to filter by.
An integer list of homeroom advisor ids to filter by.
An integer defining which page to display.
An integer defining the number of records to display per page.
A timestamp to filter the deletion date of results.
A string to search across the following fields: first_name, last_name, middle_name, nickname, other_name, email, student_id.
Success
GET /v2/students HTTP/1.1
Host: api.devel.managebac.com
Accept: */*
Success
{
"students": [
{
"id": 2054,
"email": "[email protected]",
"first_name": "Kevin",
"last_name": "Williams",
"archived": false,
"ui_language": "en",
"created_at": "2021-06-28T12:40:05.000Z",
"updated_at": "2021-06-28T12:40:05.000Z",
"student_id": "AA1001",
"identifier": "AA1001",
"gender": "Male",
"timezone": "Europe/Kyiv",
"parent_ids": [],
"street_address": "81856 Upham Place",
"city": "San Diego",
"state": "56981",
"zipcode": "82211",
"country": "SI",
"nationalities": [],
"languages": [],
"role": "Student"
}
],
"meta": {
"current_page": 1,
"total_pages": 1,
"total_count": 1,
"per_page": 100
}
}This endpoint creates a new student record. The Content-Type header must be set to application/json, and the request body should contain the field structure as a JSON payload. Only users with admin role are able to create new student records.
Your V2 API authentication token may be passed in the parameters. To protect your key, use environment variables.
Fields for create student.
Success
POST /v2/students HTTP/1.1
Host: api.devel.managebac.com
Content-Type: application/json
Accept: */*
Content-Length: 744
{
"student": {
"email": "[email protected]",
"first_name": "Richard",
"middle_name": "David",
"password": "qwerty9876",
"last_name": "Chandler",
"nickname": "Ricky",
"other_name": "",
"identifier": "AA1001",
"gender": "Male",
"birthday": "1972-10-24",
"phone_number": "977 840-2231",
"mobile_phone_number": "977 840-2231",
"street_address": "301 Massachusetts Ave",
"street_address_ii": "",
"city": "Lunenburg",
"state": "Virginia",
"zipcode": "1462",
"country": "United States",
"nationalities": [
"US",
"GB"
],
"languages": [
"ENG"
],
"timezone": "Europe/Kyiv",
"id": 123,
"sb_id": "123",
"oa_id": "123",
"graduated_on": "2018-12-11",
"withdrawn_on": "1998-09-23",
"student_id": "AA1001",
"homeroom_advisor_id": 10752544,
"year_group_id": 10209272,
"graduating_year": 2018,
"parent_ids": [
12334,
3114
]
}
}Success
{
"student": {
"id": 2063,
"email": "[email protected]",
"first_name": "Kevin",
"last_name": "Epelbaum",
"archived": false,
"ui_language": "en",
"created_at": "2021-06-28T12:40:10.000Z",
"updated_at": "2021-06-28T12:40:10.000Z",
"student_id": "AA1001",
"identifier": "AA1001",
"parent_ids": [],
"nationalities": [],
"languages": []
}
}This endpoint retrieves a single student as specified by ID. It returns personal details, including the IDs of parents. Depending on the value of the status field (withdrawn or graduated), the related date field will have a different name.
Your V2 API authentication token may be passed in the parameters. To protect your key, use environment variables.
Unique identifier for a student.
Success
GET /v2/students/{id} HTTP/1.1
Host: api.devel.managebac.com
Accept: */*
Success
{
"student": {
"id": 2057,
"email": "[email protected]",
"first_name": "Jessica",
"last_name": "Ortiz",
"archived": false,
"ui_language": "en",
"created_at": "2021-06-28T12:40:06.000Z",
"updated_at": "2021-06-28T12:40:06.000Z",
"student_id": "AA1001",
"identifier": "AA1001",
"gender": "Male",
"timezone": "Australia/Adelaide",
"ee_advisor_id": 456,
"parent_ids": [],
"street_address": "709 Fieldstone Plaza",
"city": "Pinole",
"state": "54245",
"zipcode": "39977",
"country": "NI",
"nationalities": [],
"languages": [],
"role": "Student"
}
}This endpoint updates a student record as specified by student ID. The Content-Type header must be set to application/json, and the request body should contain the fields you want to update as a JSON payload. Only users with admin role are able to update students.
Your V2 API authentication token may be passed in the parameters. To protect your key, use environment variables.
Unique identifier for a student.
Fields for create student.
Success
PATCH /v2/students/{id} HTTP/1.1
Host: api.devel.managebac.com
Content-Type: application/json
Accept: */*
Content-Length: 744
{
"student": {
"email": "[email protected]",
"first_name": "Richard",
"middle_name": "David",
"password": "qwerty9876",
"last_name": "Chandler",
"nickname": "Ricky",
"other_name": "",
"identifier": "AA1001",
"gender": "Male",
"birthday": "1972-10-24",
"phone_number": "977 840-2231",
"mobile_phone_number": "977 840-2231",
"street_address": "301 Massachusetts Ave",
"street_address_ii": "",
"city": "Lunenburg",
"state": "Virginia",
"zipcode": "1462",
"country": "United States",
"nationalities": [
"US",
"GB"
],
"languages": [
"ENG"
],
"timezone": "Europe/Kyiv",
"id": 123,
"sb_id": "123",
"oa_id": "123",
"graduated_on": "2018-12-11",
"withdrawn_on": "1998-09-23",
"student_id": "AA1001",
"homeroom_advisor_id": 10752544,
"year_group_id": 10209272,
"graduating_year": 2018,
"parent_ids": [
12334,
3114
]
}
}Success
{
"student": {
"id": 2070,
"email": "[email protected]",
"first_name": "Kevin",
"last_name": "Epelbaum",
"archived": false,
"ui_language": "en",
"created_at": "2021-06-28T12:40:12.000Z",
"updated_at": "2021-06-28T12:40:12.000Z",
"student_id": "AA1002",
"identifier": "AA1002",
"gender": "Male",
"timezone": "Atlantic/Cape_Verde",
"parent_ids": [],
"street_address": "9 Aberg Drive",
"city": "Fowler",
"state": "70059-4573",
"zipcode": "93186",
"country": "PT",
"nationalities": [],
"languages": []
}
}This endpoint archives the student record as specified by student ID. This effectively removes the record from classes, groups, etc. Either the withdrawl date or graduation date must be supplied to provide a reason for the archiving.
Your V2 API authentication token may be passed in the parameters. To protect your key, use environment variables.
Unique identifier for a student.
Success
PUT /v2/students/{id}/archive HTTP/1.1
Host: api.devel.managebac.com
Content-Type: application/json
Accept: */*
Content-Length: 23
{
"withdrawn_on": "text"
}Success
{
"status": "ok"
}This endpoint reverses the archive operation on a student record as specified by ID. This effectively restores the student in classes, groups, etc.
Your V2 API authentication token may be passed in the parameters. To protect your key, use environment variables.
Unique identifier for a student.
Success
PUT /v2/students/{id}/unarchive HTTP/1.1
Host: api.devel.managebac.com
Accept: */*
Success
{
"status": "ok"
}Last updated
Was this helpful?