> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hawkings.education/llms.txt
> Use this file to discover all available pages before exploring further.

# List submissions

## Query

<ParamField query="assignment_id" type="string" />

<ParamField query="student_id" type="string" />

<ParamField query="cohort_id" type="string" />

<ParamField query="ai_status" type="enum">`pending` | `ready` | `error`.</ParamField>
<ParamField query="human_review_status" type="enum">`pending` | `reviewed` | `off`.</ParamField>

<ParamField query="limit" type="integer" default="20" />

<ParamField query="starting_after" type="string" />

## Examples

<CodeGroup>
  ```ts TypeScript theme={null}
  // All submissions for an assignment
  const subs = await hk.submissions.list({ assignment_id: "asg_123" });

  // All submissions awaiting human review across the cohort
  const pending = await hk.submissions.list({
    cohort_id: "coh_123",
    human_review_status: "pending",
    ai_status: "ready",
  });
  ```

  ```php PHP theme={null}
  // All submissions for an assignment
  $subs = $hk->submissions->list(['assignment_id' => 'asg_123']);

  // All submissions awaiting human review across the cohort
  $pending = $hk->submissions->list([
      'cohort_id' => 'coh_123',
      'human_review_status' => 'pending',
      'ai_status' => 'ready',
  ]);
  ```
</CodeGroup>

## Returns

A paginated list of [Submission](/api-reference/submissions/object)s.