Welcome to Our New API Docs! This is the new home for all things API (previously at Canvas LMS REST API Documentation).
API for accessing course reports.
A Report object looks like:
A ReportParameters object looks like:
GET /api/v1/courses/:course_id/reports/:report_type/:id
Scope: url:GET|/api/v1/courses/:course_id/reports/:report_type/:id
Returns the status of a report.
Example Request:
Returns a object.
POST /api/v1/courses/:course_id/reports/:report_type
Scope: url:POST|/api/v1/courses/:course_id/reports/:report_type
Generates a report instance for the account. Note that “report” in the request must match one of the available report names.
Request Parameters:
Returns a object.
GET /api/v1/courses/:course_id/reports/:report_type
Scope: url:GET|/api/v1/courses/:course_id/reports/:report_type
Returns the status of the last report initiated by the current user.
Example Request:
Returns a object.
This documentation is generated directly from the Canvas LMS source code, available .
course_id
integer
The id of the course to report on.
report_type
string
The type of report to generate.
parameters[]
Hash
The parameters will vary for each report. A few example parameters have been provided below. Note: the example parameters provided below may not be valid for every report.
parameters[section_ids[]]
integer
The sections of the course to report on. Note: this parameter has been listed to serve as an example and may not be valid for every report.
{
// The unique identifier for the report.
"id": 1,
// The url to the report download.
"file_url": "https://example.com/some/path",
// The attachment api object of the report. Only available after the report has
// completed.
"attachment": null,
// The status of the report
"status": "complete",
// The date and time the report was created.
"created_at": "2013-12-01T23:59:00-06:00",
// The date and time the report started processing.
"started_at": "2013-12-02T00:03:21-06:00",
// The date and time the report finished processing.
"ended_at": "2013-12-02T00:03:21-06:00",
// The report parameters
"parameters": {"course_id":2,"start_at":"2012-07-13T10:55:20-06:00","end_at":"2012-07-13T10:55:20-06:00"},
// The progress of the report
"progress": 100
}// The parameters returned will vary for each report.
{
}curl -H 'Authorization: Bearer <token>' \
https://<canvas>/api/v1/courses/<course_id>/reports/<report_type>/<report_id>curl -H 'Authorization: Bearer <token>' \
https://<canvas>/api/v1/courses/<course_id>/reports/<report_type>