Skip to content

canvas assignments list

canvas assignments list

List assignments in a course

Synopsis

List all assignments in a Canvas course.

You can filter assignments by search term, bucket, and order.

Buckets: - past: Assignments that are past their due date - overdue: Assignments that are overdue for the current user - undated: Assignments that have no due date - ungraded: Assignments that have not been graded - unsubmitted: Assignments that have not been submitted - upcoming: Assignments that are due in the future - future: Assignments with a due date in the future

Examples:

canvas assignments list --course-id 123
canvas assignments list --course-id 123 --bucket upcoming
canvas assignments list --course-id 123 --search "quiz"
canvas assignments list --course-id 123 --order-by due_at
canvas assignments list --course-id 123 --include submission,rubric

Note: If you have set a course context (canvas context set course 123), you can omit --course-id and it will be used automatically.

canvas assignments list [flags]

Options

      --bucket string     Filter by bucket (past, overdue, undated, ungraded, unsubmitted, upcoming, future)
      --course-id int     Course ID (required, or set via 'canvas context set course')
  -h, --help              help for list
      --include strings   Additional data to include (comma-separated)
      --order-by string   Order by (position, name, due_at)
      --search string     Search by assignment name

Options inherited from parent commands

      --as-user int       Masquerade as another user (admin feature, requires permission)
      --columns strings   Select specific columns to display (comma-separated)
      --config string     config file (default is $HOME/.canvas-cli/config.yaml)
      --dry-run           Print curl commands instead of executing requests
      --filter string     Filter results by text (case-insensitive substring match)
      --instance string   Canvas instance URL (overrides config)
      --limit int         Limit number of results for list operations (0 = unlimited)
      --no-cache          Disable caching of API responses
  -o, --output string     Output format: table, json, yaml, csv (default "table")
      --show-token        Show actual token in dry-run output (default: redacted)
      --sort string       Sort results by field (prefix with - for descending, e.g., -name)
  -v, --verbose           Enable verbose output

SEE ALSO

Auto generated by spf13/cobra on 25-Jan-2026