Year Groups

A Year Group is a collection of student memberships in a cohort that share the same Program.

Get all Year Groups

get

/v2p2/year-groups

This endpoint retrieves the basic information of all Year Groups. It returns the group name, program, program_code, grade level and student IDs for members.

Authorizations

auth_tokenstringRequired

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

Query parameters

modified_sincestringOptional

A timestamp to filter results by modification date.

pagestringOptional

An integer defining which page to display.

per_pagestringOptional

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

archivedbooleanOptional

A boolean that, if set to true, returns only archived groups.

student_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/year-groups

GET /v2p2/year-groups HTTP/1.1
Host: api.managebac.com
Accept: */*

200

Success

{
  "year_groups": [
    {
      "id": 10907398,
      "name": "IB Diploma Group of 2019 (Grade 12)",
      "short_name": "IB Diploma Group of 2019",
      "program": "IB Diploma",
      "program_code": "diploma",
      "grade": "Grade 12",
      "archived": false,
      "grade_number": 13,
      "graduation_year": 2025,
      "student_ids": [
        10193652
      ]
    },
    {
      "id": 11076103,
      "name": "IB MYP Group of 2019 (Year 4)",
      "short_name": "IB MYP Group of 2019",
      "program": "IB Middle Years",
      "program_code": "myp",
      "grade": "Year 4",
      "archived": false,
      "grade_number": 10,
      "graduation_year": 2019,
      "student_ids": [
        12459565,
        11456849,
        12068809
      ]
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 2,
    "per_page": 100
  }
}

Get Students for a Year Group

get

/v2p2/year-groups/{id}/students

This endpoint retrieves all students belonging to a year group, as specified by the year group ID.

Authorizations

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 year group.

Query parameters

pagestringOptional

An integer defining which page to display.

per_pagestringOptional

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

student_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/year-groups/{id}/students

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

200

Success

{
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 3,
    "per_page": 100
  },
  "student_ids": [
    10193652,
    12449380,
    12569245
  ],
  "students": [
    {
      "id": 10193652,
      "email": "[email protected]",
      "first_name": "John",
      "last_name": "Cage",
      "archived": false,
      "created_at": "2018-09-15T06:31:08.000-07:00",
      "updated_at": "2021-02-23T00:57:49.000-08:00",
      "last_accessed_at": "2021-02-25T08:13:03.000-08:00",
      "gender": "Male",
      "birthday": "1994-08-01",
      "mobile_phone_number": "",
      "student_id": "857906",
      "cas_advisor_id": 10559037,
      "class_grade": "Grade 10",
      "class_grade_number": 11,
      "program": "IB Diploma",
      "program_code": "diploma",
      "ib_group_id": 10342694,
      "year_group_id": 10342694,
      "parent_ids": [],
      "street_address": "",
      "city": "New York",
      "state": "",
      "zipcode": "",
      "country": "US",
      "nationalities": [
        "US"
      ],
      "languages": [
        "ENG",
        "SPA"
      ],
      "graduating_year": 2023,
      "role": "Student"
    },
    {
      "id": 12449380,
      "email": "[email protected]",
      "first_name": "Blue Ivy",
      "last_name": "Carter",
      "archived": false,
      "created_at": "2014-03-11T06:50:34.000-07:00",
      "updated_at": "2021-02-23T00:57:48.000-08:00",
      "student_id": "",
      "class_grade": "Grade 10",
      "class_grade_number": 11,
      "program": "IB Diploma",
      "program_code": "diploma",
      "ib_group_id": 10342694,
      "year_group_id": 10342694,
      "parent_ids": [
        10193613,
        12425959
      ],
      "nationalities": [],
      "languages": [],
      "graduating_year": 2023,
      "role": "Student"
    },
    {
      "id": 12569245,
      "email": "[email protected]",
      "first_name": "Robyn",
      "last_name": "Anderson",
      "archived": false,
      "created_at": "2014-10-23T06:12:42.000-07:00",
      "updated_at": "2021-02-23T00:57:49.000-08:00",
      "phone_number": "",
      "mobile_phone_number": "",
      "national_id": "",
      "student_id": "",
      "class_grade": "Grade 10",
      "class_grade_number": 11,
      "program": "IB Diploma",
      "program_code": "diploma",
      "ib_group_id": 10342694,
      "year_group_id": 10342694,
      "parent_ids": [],
      "street_address": "99590 Johnson Park",
      "street_address_ii": "",
      "city": "Fort Lauderdale",
      "state": "FL",
      "zipcode": "72146",
      "country": "US",
      "nationalities": [],
      "languages": [],
      "graduating_year": 2023,
      "role": "Student"
    }
  ]
}

Add Students to a Year Group

post

/v2p2/year-groups/{id}/add_students

This endpoint adds a list of student IDs to a year group, as specified by the year group ID.

Authorizations

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 year group.

Body

student_idsinteger[]Required

An array of student IDs to be added to a year group

Responses

200

Success

application/json

post

/v2p2/year-groups/{id}/add_students

POST /v2p2/year-groups/{id}/add_students HTTP/1.1
Host: api.managebac.com
Content-Type: application/json
Accept: */*
Content-Length: 19

{
  "student_ids": [
    1
  ]
}

200

Success

{
  "status": "ok"
}

Remove Students from a Year Group

post

/v2p2/year-groups/{id}/remove_students

This endpoint removes a list of student IDs from a year group, as specified by the year group ID.

Authorizations

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 year group.

Body

student_idsinteger[]Required

An array of Student IDs to remove from the Year Group

Responses

200

Success

application/json

post

/v2p2/year-groups/{id}/remove_students

POST /v2p2/year-groups/{id}/remove_students HTTP/1.1
Host: api.managebac.com
Content-Type: application/json
Accept: */*
Content-Length: 19

{
  "student_ids": [
    1
  ]
}

200

Success

{
  "status": "ok"
}

Get Advisors

get

/v2p2/year-groups/{id}/advisors

Retrieves the Homeroom, CAS, EE, TOK, Project-based Learning advisors for a Year Group, specified by id. Returns advisor IDs and role abbreviations.

Authorizations

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 year group.

Responses

200

Success

application/json

get

/v2p2/year-groups/{id}/advisors

GET /v2p2/year-groups/{id}/advisors HTTP/1.1
Host: api.managebac.com
Accept: */*

200

Success

{
  "advisors": [
    {
      "id": 10193613,
      "roles": [
        "homeroom",
        "cas",
        "M25",
        "EXT"
      ]
    },
    {
      "id": 12425959,
      "roles": [
        "ee",
        "tok",
        "M25"
      ]
    }
  ]
}

Get CAS Experiences for Students in a Year Group

get

/v2p2/year-groups/{id}/projects/cas/experiences/students

This endpoint retrieves CAS experiences for students in a Year Group. Results are paginated and can be filtered by student IDs. Each student includes a component object containing experiences.

Authorizations

auth_tokenstringRequired

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

Path parameters

idintegerRequired

Year Group ID

Query parameters

student_ids[]integer[]Optional

Filter by student IDs

pageintegerOptional

Page number for pagination

per_pageintegerOptional

Number of results per page (max 500)

Responses

200

Success

application/json

401

Unauthorized

application/json

404

Not found

application/json

get

/v2p2/year-groups/{id}/projects/cas/experiences/students

GET /v2p2/year-groups/{id}/projects/cas/experiences/students HTTP/1.1
Host: api.managebac.com
Accept: */*

{
  "students": [
    {
      "id": 11084604,
      "identifier": "STU001",
      "component": {
        "items": [
          {
            "id": 22301859,
            "name": "Model United Nations",
            "status": {
              "post_approved": true,
              "pre_approved": true,
              "progress": {
                "title": "completed"
              }
            },
            "status_annotations": {
              "incomplete": false,
              "rejected": false,
              "reviewed": true
            },
            "supervisor": {
              "name": "Jane Smith",
              "email": "[email protected]",
              "title": "Program Coordinator",
              "contact_number": "+1234567890"
            },
            "cas_project": true,
            "creativity": true,
            "creativity_hours": 20,
            "activity": true,
            "activity_hours": 20,
            "service": true,
            "service_hours": 10,
            "service_action_type": "Direct",
            "ongoing_approach": true,
            "school_based_approach": false,
            "community_based_approach": true,
            "individual_approach": false,
            "start_date": "2025-01-15",
            "end_date": "2025-06-30",
            "slug": "experiences"
          }
        ]
      }
    },
    {
      "id": 10193652,
      "identifier": "STU002",
      "component": {
        "items": []
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "next_page": null,
    "prev_page": null,
    "total_pages": 1,
    "total_count": 2,
    "per_page": 100
  }
}

Get CAS settings for a Year Group

get

/v2p2/year-groups/{id}/projects/cas

This endpoint retrieves CAS settings and component configuration for a Year Group.

Authorizations

auth_tokenstringRequired

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

Path parameters

idintegerRequired

Year Group ID

Responses

200

Success

application/json

401

Unauthorized

application/json

404

Not found

application/json

get

/v2p2/year-groups/{id}/projects/cas

GET /v2p2/year-groups/{id}/projects/cas HTTP/1.1
Host: api.managebac.com
Accept: */*

{
  "cas": {
    "components": [
      {
        "slug": "experiences",
        "label": "Experiences",
        "track_hours": true,
        "show_hours_chart": true,
        "cas_total_hours": 150,
        "show_aims_and_goals": true,
        "optional_question": "What are your goals?",
        "activity_description_title": "Description and Goals"
      }
    ]
  }
}

PreviousAcademics NextClasses

Last updated 3 days ago

Was this helpful?

hashtagGet all Year Groups

hashtagGet Students for a Year Group

hashtagAdd Students to a Year Group

hashtagRemove Students from a Year Group

hashtagGet Advisors

hashtagGet CAS Experiences for Students in a Year Group

hashtagGet CAS settings for a Year Group

Get all Year Groups

Get Students for a Year Group

Add Students to a Year Group

Remove Students from a Year Group

Get Advisors

Get CAS Experiences for Students in a Year Group

Get CAS settings for a Year Group