> ## Documentation Index > Fetch the complete documentation index at: https://docs.classquill.com/llms.txt > Use this file to discover all available pages before exploring further. # List Homework > List assessments assigned by the org's tutors (most recent first). One row per `assessment_assignments` row — a paper assigned to two classrooms is two homework rows with two due dates. Scoped by the assignment's TARGET (the org's classrooms, its groups, and its affiliated students for 1:1 rows) rather than a stamped org column: `assessment_assignments` has none, and the paper's `assessments.org_id` is only set for org-tier papers, so a classroom paper authored inside an org classroom would otherwise vanish from this list. Same id sets `_org_scope` computes for every other cross-org read. A student-scope (1:1) row additionally requires `assigned_by` to be one of the org's staff, so another tutor's private work for a shared student never lists here (F4). `homework_type` is the paper's `kind` — a label, six values, never a behaviour. ## OpenAPI ````yaml /openapi.json get /v1/homework openapi: 3.1.0 info: title: ClassQuill Public API description: >- REST API for ClassQuill tutoring organisations. Pipe your sessions, invoices, payments, tutor earnings, students, and more into your own tools. Most endpoints are reads; a focused set of writes (each gated by a *:write scope) create or update data, including creating student/tutor/parent accounts. Authenticate every request with an org API key: Authorization: Token token=cq_live_... Mint keys in the ClassQuill app under Settings → Developers. version: 1.0.0 servers: [] security: - ApiKeyAuth: [] tags: - name: General - name: Sessions - name: Tutors - name: Students & Parents - name: Billing - name: Curriculum - name: Coursework - name: Operations - name: Pricing - name: Bookings - name: Blog - name: Reports paths: /v1/homework: get: tags: - Coursework summary: List Homework description: >- List assessments assigned by the org's tutors (most recent first). One row per `assessment_assignments` row — a paper assigned to two classrooms is two homework rows with two due dates. Scoped by the assignment's TARGET (the org's classrooms, its groups, and its affiliated students for 1:1 rows) rather than a stamped org column: `assessment_assignments` has none, and the paper's `assessments.org_id` is only set for org-tier papers, so a classroom paper authored inside an org classroom would otherwise vanish from this list. Same id sets `_org_scope` computes for every other cross-org read. A student-scope (1:1) row additionally requires `assigned_by` to be one of the org's staff, so another tutor's private work for a shared student never lists here (F4). `homework_type` is the paper's `kind` — a label, six values, never a behaviour. operationId: list_homework_v1_homework_get parameters: - name: homework_type in: query required: false schema: anyOf: - type: string - type: 'null' description: quiz, homework, test, exam, practice, diagnostic title: Homework Type description: quiz, homework, test, exam, practice, diagnostic - name: scope in: query required: false schema: anyOf: - type: string - type: 'null' description: classroom, group, student title: Scope description: classroom, group, student - name: student_id in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by assigned student UUID title: Student Id description: Filter by assigned student UUID - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Opaque cursor from a previous response's meta.next_cursor, or the literal 'start' to begin cursor paging from the newest record. When set, offset is ignored and results page by a stable (created_at, id) keyset — recommended for large or incremental syncs. title: Cursor description: >- Opaque cursor from a previous response's meta.next_cursor, or the literal 'start' to begin cursor paging from the newest record. When set, offset is ignored and results page by a stable (created_at, id) keyset — recommended for large or incremental syncs. - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Records per page (default 20, max 100) default: 20 title: Limit description: Records per page (default 20, max 100) - name: offset in: query required: false schema: type: integer minimum: 0 description: Pagination offset (ignored when cursor is set) default: 0 title: Offset description: Pagination offset (ignored when cursor is set) responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/Page_Homework_' '401': description: Missing, malformed, revoked, or expired credentials. content: application/json: schema: $ref: '#/components/schemas/ApiError' '403': description: The credential lacks the scope this endpoint requires. content: application/json: schema: $ref: '#/components/schemas/ApiError' '422': description: Validation error — `error.details.errors` lists the fields. content: application/json: schema: $ref: '#/components/schemas/ApiError' '429': description: >- Rate limit exceeded — honour Retry-After and the RateLimit-* headers. content: application/json: schema: $ref: '#/components/schemas/ApiError' components: schemas: Page_Homework_: properties: data: items: $ref: '#/components/schemas/Homework' type: array title: Data meta: $ref: '#/components/schemas/PageMeta' type: object required: - data - meta title: Page[Homework] ApiError: description: Canonical error envelope for every /v1 error response (4xx/5xx). properties: error: $ref: '#/components/schemas/ApiErrorBody' required: - error title: ApiError type: object Homework: properties: id: type: string title: Id assigned_by: anyOf: - type: string - type: 'null' title: Assigned By title: anyOf: - type: string - type: 'null' title: Title description: anyOf: - type: string - type: 'null' title: Description homework_type: anyOf: - type: string - type: 'null' title: Homework Type description: >- The paper's kind: quiz, homework, test, exam, practice or diagnostic. scope: anyOf: - type: string - type: 'null' title: Scope classroom_id: anyOf: - type: string - type: 'null' title: Classroom Id group_id: anyOf: - type: string - type: 'null' title: Group Id student_id: anyOf: - type: string - type: 'null' title: Student Id due_date: anyOf: - type: string - type: 'null' title: Due Date files: items: {} type: array title: Files default: [] created_at: anyOf: - type: string - type: 'null' title: Created At type: object required: - id title: Homework description: >- One assignment of a paper to a classroom, group or student. Since phase 3 this is an `assessment_assignments` row joined to its `assessments` paper — a paper assigned to two classrooms is two rows with two due dates. PageMeta: properties: limit: type: integer title: Limit offset: anyOf: - type: integer - type: 'null' title: Offset count: anyOf: - type: integer - type: 'null' title: Count total: anyOf: - type: integer - type: 'null' title: Total next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor description: >- Cursor-mode only: pass as ?cursor= to fetch the next page; null when this is the last page. type: object required: - limit title: PageMeta description: |- Pagination envelope metadata. `count` is the size of the returned page; `total` (when present) is the full result-set size for offset paging. In cursor mode `offset`/`total` are absent and `next_cursor` carries the opaque token for the next page (null on the last page). ApiErrorBody: description: The `error` object every /v1 error response carries. properties: code: description: >- Stable machine-readable error code: bad_request, unauthorized, forbidden, not_found, conflict, validation_error, rate_limited, or internal_error. examples: - not_found title: Code type: string message: description: Human-readable explanation, safe to surface to end users. examples: - Session not found title: Message type: string status: description: The HTTP status code, repeated in the body. examples: - 404 title: Status type: integer details: additionalProperties: true description: >- Error-specific context. 422 carries the field errors under `errors`; 429 carries `retry_after_seconds`. title: Details type: object required: - code - message - status title: ApiErrorBody type: object securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization description: Org API key as `Token token=cq_live_...` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.