Projects

This group refers to endpoints related to projects.

Get Student Proposal Progress for a Year Group PBL

get

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

/v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/proposal/students

This endpoint retrieves information about Year Group students PBL details for Proposal component.

Authorizations

authTokenQueryauthTokenHeader

auth_tokenstringRequired

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

Path parameters

year_group_idintegerRequired

A Year Group ID.

project_idintegerRequired

A PBL Project ID.

Query parameters

archivedbooleanOptional

A boolean parameter to filter archived or active Year Groups

include_archived_studentsbooleanOptional

A boolean parameter to specify that specifies if archived students are included in response

Responses

200

Success

application/json

404

Not Found

get

/v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/proposal/students

HTTPcURLJavaScriptPython

GET /v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/proposal/students HTTP/1.1
Host: api.managebac.com
Accept: */*

{
  "students": [
    {
      "id": 12345,
      "identifier": "S2025-52-4",
      "status": {
        "progress": {
          "id": 312,
          "title": "Excellent",
          "default": true
        },
        "approved": false,
        "completed": false
      },
      "supervisor": {
        "id": 1232,
        "identifier": "S2025-52-s"
      },
      "component": {
        "slug": "proposal",
        "items": [
          {
            "id": 12,
            "title": "Field Text",
            "kind": "radio_buttons",
            "value": null
          }
        ]
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 1,
    "per_page": 100
  }
}

Get Student Reflection Progress for a Year Group PBL

get

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

/v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/reflections/students

This endpoint retrieves information about Year Group students PBL details for Reflections component.

Authorizations

authTokenQueryauthTokenHeader

auth_tokenstringRequired

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

Path parameters

year_group_idintegerRequired

A Year Group ID.

project_idintegerRequired

A PBL Project ID.

Query parameters

archivedbooleanOptional

A boolean parameter to filter archived or active Year Groups

include_archived_studentsbooleanOptional

A boolean parameter to specify that specifies if archived students are included in response

Responses

200

Success

application/json

404

Not Found

get

/v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/reflections/students

HTTPcURLJavaScriptPython

GET /v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/reflections/students HTTP/1.1
Host: api.managebac.com
Accept: */*

{
  "students": [
    {
      "id": 12345,
      "identifier": "S2025-52-4",
      "status": {
        "progress": {
          "id": 312,
          "title": "Excellent",
          "default": true
        },
        "approved": false,
        "completed": false
      },
      "supervisor": {
        "id": 1232,
        "identifier": "S2025-52-s"
      },
      "component": {
        "slug": "reflections",
        "items": [
          {
            "id": 12,
            "title": "Field Text",
            "submitted": false
          }
        ]
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 1,
    "per_page": 100
  }
}

Get Student Personal Todos and Deadlines for a Year Group PBL

get

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

/v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/todos/students

This endpoint retrieves information about Year Group students PBL details for Todos component.

Authorizations

authTokenQueryauthTokenHeader

auth_tokenstringRequired

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

Path parameters

year_group_idintegerRequired

A Year Group ID.

project_idintegerRequired

A PBL Project ID.

Query parameters

archivedbooleanOptional

A boolean parameter to filter archived or active Year Groups

include_archived_studentsbooleanOptional

A boolean parameter to specify that specifies if archived students are included in response

Responses

200

Success

application/json

404

Not Found

get

/v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/todos/students

HTTPcURLJavaScriptPython

GET /v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/todos/students HTTP/1.1
Host: api.managebac.com
Accept: */*

{
  "students": [
    {
      "id": 12345,
      "identifier": "S2025-52-4",
      "status": {
        "progress": {
          "id": 312,
          "title": "Excellent",
          "default": true
        },
        "approved": false,
        "completed": false
      },
      "supervisor": {
        "id": 1232,
        "identifier": "S2025-52-s"
      },
      "component": {
        "slug": "todos",
        "personal_todos": [
          {
            "id": 1,
            "title": "Project Title",
            "completed": false
          }
        ],
        "deadlines": [
          {
            "id": 12,
            "title": "Deadline Title",
            "todos": [
              {
                "id": 123,
                "title": "Todo Title",
                "completed": false
              }
            ]
          }
        ]
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 1,
    "per_page": 100
  }
}

Get Student Journal Entries for a Year Group PBL

get

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

/v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/journal/students

This endpoint retrieves information about Year Group students PBL details for Journal component.

Authorizations

authTokenQueryauthTokenHeader

auth_tokenstringRequired

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

Path parameters

year_group_idintegerRequired

A Year Group ID.

project_idintegerRequired

A PBL Project ID.

Query parameters

archivedbooleanOptional

A boolean parameter to filter archived or active Year Groups

include_archived_studentsbooleanOptional

A boolean parameter to specify that specifies if archived students are included in response

Responses

200

Success

application/json

404

Not Found

get

/v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/journal/students

HTTPcURLJavaScriptPython

GET /v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/journal/students HTTP/1.1
Host: api.managebac.com
Accept: */*

{
  "students": [
    {
      "id": 12345,
      "identifier": "S2025-52-4",
      "status": {
        "progress": {
          "id": 312,
          "title": "Excellent",
          "default": true
        },
        "approved": false,
        "completed": false
      },
      "supervisor": {
        "id": 1232,
        "identifier": "S2025-52-s"
      },
      "component": {
        "slug": "journal",
        "items": [
          {
            "id": 1,
            "kind": "journal",
            "title": null,
            "description": null,
            "author_id": 12,
            "created_at": "2025-11-19T22:06:09Z",
            "files": [],
            "body": "Test 1",
            "photos": [],
            "url": null
          }
        ]
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 1,
    "per_page": 100
  }
}

Get Student Documents for a Year Group PBL

get

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

/v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/documents/students

This endpoint retrieves information about Year Group students PBL details for Documents component.

Authorizations

authTokenQueryauthTokenHeader

auth_tokenstringRequired

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

Path parameters

year_group_idintegerRequired

A Year Group ID.

project_idintegerRequired

A PBL Project ID.

Query parameters

archivedbooleanOptional

A boolean parameter to filter archived or active Year Groups

include_archived_studentsbooleanOptional

A boolean parameter to specify that specifies if archived students are included in response

Responses

200

Success

application/json

404

Not Found

get

/v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/documents/students

HTTPcURLJavaScriptPython

GET /v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/documents/students HTTP/1.1
Host: api.managebac.com
Accept: */*

{
  "students": [
    {
      "id": 12345,
      "identifier": "S2025-52-4",
      "status": {
        "progress": {
          "id": 312,
          "title": "Excellent",
          "default": true
        },
        "approved": false,
        "completed": false
      },
      "supervisor": {
        "id": 1232,
        "identifier": "S2025-52-s"
      },
      "component": {
        "slug": "documents",
        "items": [
          {
            "id": 1,
            "filename": "document.txt",
            "url": "https://example.com/uploads/store/asset/file/16/document.txt",
            "created_at": "2025-11-20T00:05:14Z"
          }
        ]
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 1,
    "per_page": 100
  }
}

Get Student Presentations for a Year Group PBL

get

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

/v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/presentation/students

This endpoint retrieves information about Year Group students PBL details for Presentation component.

Authorizations

authTokenQueryauthTokenHeader

auth_tokenstringRequired

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

Path parameters

year_group_idintegerRequired

A Year Group ID.

project_idintegerRequired

A PBL Project ID.

Query parameters

archivedbooleanOptional

A boolean parameter to filter archived or active Year Groups

include_archived_studentsbooleanOptional

A boolean parameter to specify that specifies if archived students are included in response

Responses

200

Success

application/json

404

Not Found

get

/v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/presentation/students

HTTPcURLJavaScriptPython

GET /v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/presentation/students HTTP/1.1
Host: api.managebac.com
Accept: */*

{
  "students": [
    {
      "id": 12345,
      "identifier": "S2025-52-4",
      "status": {
        "progress": {
          "id": 312,
          "title": "Excellent",
          "default": true
        },
        "approved": false,
        "completed": false
      },
      "supervisor": {
        "id": 1232,
        "identifier": "S2025-52-s"
      },
      "component": {
        "slug": "presentation",
        "title": "Presentation",
        "duration": null,
        "documents": [
          {
            "id": 1,
            "caption": "uploaded file",
            "url": "https://example.com/uploads/store/asset/file/16/document.txt",
            "created_at": "2025-11-20T09:28:39Z"
          }
        ],
        "items": [
          {
            "title": "Presentation Field Title",
            "value": "Value 1, Value 2"
          }
        ]
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 1,
    "per_page": 100
  }
}

Get Student Notes & Interviews for a Year Group PBL

get

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

/v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/notes_and_interviews/students

This endpoint retrieves information about Year Group students PBL details for Notes and Interviews component.

Authorizations

authTokenQueryauthTokenHeader

auth_tokenstringRequired

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

Path parameters

year_group_idintegerRequired

A Year Group ID.

project_idintegerRequired

A PBL Project ID.

Query parameters

archivedbooleanOptional

A boolean parameter to filter archived or active Year Groups

include_archived_studentsbooleanOptional

A boolean parameter to specify that specifies if archived students are included in response

Responses

200

Success

application/json

404

Not Found

get

/v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/notes_and_interviews/students

HTTPcURLJavaScriptPython

GET /v2p1/year-groups/{year_group_id}/projects/pbl/{project_id}/notes_and_interviews/students HTTP/1.1
Host: api.managebac.com
Accept: */*

{
  "students": [
    {
      "id": 12345,
      "identifier": "S2025-52-4",
      "status": {
        "progress": {
          "id": 312,
          "title": "Excellent",
          "default": true
        },
        "approved": false,
        "completed": false
      },
      "supervisor": {
        "id": 1232,
        "identifier": "S2025-52-s"
      },
      "component": {
        "slug": "notes_and_interviews",
        "items": [
          {
            "id": 1,
            "author": {
              "id": 123
            },
            "interview": true,
            "title": "Interview Title",
            "body": "Interview Body"
          }
        ]
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 1,
    "per_page": 100
  }
}

Get all Year Group Project Based Learning

get

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

/v2p1/year-groups/{id}/projects/pbl

This endpoint retrieves information about Year Group PBL details.

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

A Year Group ID.

Query parameters

archivedbooleanOptional

A boolean parameter to filter archived or active Year Groups

Responses

200

Success

application/json

get

/v2p1/year-groups/{id}/projects/pbl

HTTPcURLJavaScriptPython

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

200

Success

{
  "pbl": [
    {
      "id": 396,
      "title": "TOK Essay",
      "abbreviation": "TOK",
      "archived": false,
      "subject": {
        "id": 798,
        "name": "Theory of Knowledge"
      },
      "description": "The TOK essay is the external assessment for TOK. Students are required to write an essay in response to one of the six prescribed titles that are issued by the IB for each examination session.",
      "components": [
        {
          "slug": "proposal",
          "label": "Prescribed Title",
          "enabled": true
        },
        {
          "slug": "todos",
          "label": "To Dos",
          "enabled": true
        },
        {
          "slug": "documents",
          "label": "Documents",
          "enabled": true
        },
        {
          "slug": "notes_and_interviews",
          "label": "Notes",
          "enabled": true
        }
      ]
    }
  ]
}