Students

Students are child users who use ManageBac to learn

Update Student Avatar

put

https://api.managebac.comhttps://api.managebac.cnhttps://api.us.managebac.comhttps://api.managebac.ushttps://api.managebactest.comhttps://{Host}

/v2p2/students/{id}/avatar

This endpoint allows to update student's avatar.

Authorizations

authTokenQueryauthTokenHeader

auth_tokenstringRequired

Your V2 API authentication token may be passed in the parameters. To protect your key, use environment variables.

Path parameters

idintegerRequired

Unique identifier for a student.

Body

application/jsonmultipart/form-data

avatarany ofOptional

or

Responses

200

Success

application/json

422

Bad Request

application/json

put

/v2p2/students/{id}/avatar

HTTPcURLJavaScriptPython

PUT /v2p2/students/{id}/avatar HTTP/1.1
Host: api.managebac.com
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "avatar": {
    "remote_file_url": "text"
  }
}

application/jsonmultipart/form-data

{
  "status": "ok"
}

Delete Student Avatar

delete

https://api.managebac.comhttps://api.managebac.cnhttps://api.us.managebac.comhttps://api.managebac.ushttps://api.managebactest.comhttps://{Host}

/v2p2/students/{id}/avatar

This endpoint allows to delete student's avatar.

Authorizations

authTokenQueryauthTokenHeader

auth_tokenstringRequired

Your V2 API authentication token may be passed in the parameters. To protect your key, use environment variables.

Path parameters

idintegerRequired

Unique identifier for a student.

Responses

200

Success

application/json

delete

/v2p2/students/{id}/avatar

HTTPcURLJavaScriptPython

DELETE /v2p2/students/{id}/avatar HTTP/1.1
Host: api.managebac.com
Accept: */*

200

Success

{
  "status": "ok"
}

Get all Students

get

https://api.managebac.comhttps://api.managebac.cnhttps://api.us.managebac.comhttps://api.managebac.ushttps://api.managebactest.comhttps://{Host}

/v2p2/students

This endpoint retrieves all students. It returns personal details and program as well as any School-defined values.

Authorizations

authTokenQueryauthTokenHeader

auth_tokenstringRequired

Your V2 API authentication token may be passed in the parameters. To protect your key, use environment variables.

Query parameters

ids[]integer[]Optional

Return only records with the given IDs.

archivedbooleanOptional

Return only archived (1) or only active (0) students. If value is not specified, all students are returned.

statusstringOptional

Return students by status. Available statuses: enrolled, withdrawn, graduated. If value is not specified, all students are returned.

modified_sincestringOptional

A timestamp to filter the modification date of results.

year_group_idsinteger[]Optional

An integer list of year group ids to filter by.

year_group_ids[]integer[]Optional

An integer list of year group ids to filter by.

homeroom_advisor_idsinteger[]Optional

An integer list of homeroom advisor ids to filter by.

homeroom_advisor_ids[]integer[]Optional

An integer list of homeroom advisor ids to filter by.

pagestringOptional

An integer defining which page to display.

per_pagestringOptional

An integer defining the number of records to display per page.

deleted_sincestringOptional

A timestamp to filter the deletion date of results.

qstringOptional

A string to search across the following fields: first_name, last_name, middle_name, nickname, other_name, email, student_id.

idsinteger[]Optional

List of student ids. Accepts repeated params or a comma-separated string.

Example: student_ids=1,2,3 OR student_ids[]=1&student_ids[]=2

Responses

200

Success

application/json

get

/v2p2/students

HTTPcURLJavaScriptPython

GET /v2p2/students HTTP/1.1
Host: api.managebac.com
Accept: */*

200

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
  }
}

Create New Student

post

https://api.managebac.comhttps://api.managebac.cnhttps://api.us.managebac.comhttps://api.managebac.ushttps://api.managebactest.comhttps://{Host}

/v2p2/students

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.

Authorizations

authTokenQueryauthTokenHeader

auth_tokenstringRequired

Your V2 API authentication token may be passed in the parameters. To protect your key, use environment variables.

Body

application/json

studentall ofRequired

anyOptional

or

and

anyOptional

Fields for create student.

Responses

201

Success

application/json

post

/v2p2/students

HTTPcURLJavaScriptPython

POST /v2p2/students HTTP/1.1
Host: api.managebac.com
Content-Type: application/json
Accept: */*
Content-Length: 524

{
  "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"
  }
}

201

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": []
  }
}

Get a Student

get

https://api.managebac.comhttps://api.managebac.cnhttps://api.us.managebac.comhttps://api.managebac.ushttps://api.managebactest.comhttps://{Host}

/v2p2/students/{id}

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.

Authorizations

authTokenQueryauthTokenHeader

auth_tokenstringRequired

Your V2 API authentication token may be passed in the parameters. To protect your key, use environment variables.

Path parameters

idintegerRequired

Unique identifier for a student.

Responses

200

Success

application/json

get

/v2p2/students/{id}

HTTPcURLJavaScriptPython

GET /v2p2/students/{id} HTTP/1.1
Host: api.managebac.com
Accept: */*

200

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"
  }
}

Update a Student

patch

https://api.managebac.comhttps://api.managebac.cnhttps://api.us.managebac.comhttps://api.managebac.ushttps://api.managebactest.comhttps://{Host}

/v2p2/students/{id}

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.

Authorizations

authTokenQueryauthTokenHeader

auth_tokenstringRequired

Your V2 API authentication token may be passed in the parameters. To protect your key, use environment variables.

Path parameters

idintegerRequired

Unique identifier for a student.

Body

application/json

studentall ofOptional

anyOptional

or

and

anyOptional

Fields for create student.

Responses

200

Success

application/json

patch

/v2p2/students/{id}

HTTPcURLJavaScriptPython

PATCH /v2p2/students/{id} HTTP/1.1
Host: api.managebac.com
Content-Type: application/json
Accept: */*
Content-Length: 524

{
  "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"
  }
}

200

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": []
  }
}

Archive a Student

put

https://api.managebac.comhttps://api.managebac.cnhttps://api.us.managebac.comhttps://api.managebac.ushttps://api.managebactest.comhttps://{Host}

/v2p2/students/{id}/archive

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.

Authorizations

authTokenQueryauthTokenHeader

auth_tokenstringRequired

Your V2 API authentication token may be passed in the parameters. To protect your key, use environment variables.

Path parameters

idintegerRequired

Unique identifier for a student.

Body

application/json

or

Responses

200

Success

application/json

put

/v2p2/students/{id}/archive

HTTPcURLJavaScriptPython

PUT /v2p2/students/{id}/archive HTTP/1.1
Host: api.managebac.com
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "withdrawn_on": "text"
}

200

Success

{
  "status": "ok"
}

Unarchive a Student

put

https://api.managebac.comhttps://api.managebac.cnhttps://api.us.managebac.comhttps://api.managebac.ushttps://api.managebactest.comhttps://{Host}

/v2p2/students/{id}/unarchive

This endpoint reverses the archive operation on a student record as specified by ID. This effectively restores the student in classes, groups, etc.

Authorizations

authTokenQueryauthTokenHeader

auth_tokenstringRequired

Your V2 API authentication token may be passed in the parameters. To protect your key, use environment variables.

Path parameters

idintegerRequired

Unique identifier for a student.

Responses

200

Success

application/json

put

/v2p2/students/{id}/unarchive

HTTPcURLJavaScriptPython

PUT /v2p2/students/{id}/unarchive HTTP/1.1
Host: api.managebac.com
Accept: */*

200

Success

{
  "status": "ok"
}