canvas submissions list
canvas submissions list¶
List submissions for an assignment
Synopsis¶
List all submissions for a Canvas assignment.
You can filter submissions by workflow state and graded since date.
Workflow States: - submitted: Submissions that have been submitted - unsubmitted: Submissions that have not been submitted - graded: Submissions that have been graded - pending_review: Submissions pending review
Examples:
canvas submissions list --course-id 123 --assignment-id 456
canvas submissions list --course-id 123 --assignment-id 456 --workflow-state graded
canvas submissions list --course-id 123 --assignment-id 456 --include user,submission_comments
canvas submissions list --course-id 123 --assignment-id 456 --graded-since 2024-01-01
Options¶
--assignment-id int Assignment ID (required)
--course-id int Course ID (required)
--graded-since string Filter by graded since date (ISO8601 format)
-h, --help help for list
--include strings Additional data to include (comma-separated)
--workflow-state string Filter by workflow state (submitted, unsubmitted, graded, pending_review)
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¶
- canvas submissions - Manage Canvas submissions