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

# List runs

> Paging this org's runs via the Seltz Agent API, newest first

To see every run your organization has started or find one you lost track of the
ID for, list runs instead of tracking IDs yourself.

[`list`](/api-reference/agent/list-runs) pages this org's runs, newest
first, unpaged beyond the cursor. Page size is
[`limit`](/api-reference/agent/list-runs#parameter-limit) (1-100, default
20\); pass the previous page's `next` as
[`after`](/api-reference/agent/list-runs#parameter-after) to continue.

<CodeGroup>
  ```python Python theme={null}
  page = client.agent.list(limit=20)

  for run in page.runs:
      print(run.id, run.status)

  # Next page
  if page.next:
      next_page = client.agent.list(limit=20, after=page.next)
  ```

  ```typescript TypeScript theme={null}
  const page = await client.agent.list({ limit: 20 });

  for (const run of page.runs) {
    console.log(run.id, run.status);
  }

  // Next page
  if (page.next) {
    const nextPage = await client.agent.list({ limit: 20, after: page.next });
  }
  ```

  ```bash cURL theme={null}
  curl "https://api.seltz.ai/v1/agent/runs?limit=20" \
    -H "x-api-key: $SELTZ_API_KEY"
  ```
</CodeGroup>

[`next`](/api-reference/agent/list-runs#response-next-one-of-0) is unset on
the last page. There is no `has_more` field on this listing. An unset `next`
is the signal to stop.

## Next steps

* [Poll for completion](/agent/guides/poll-for-completion): managing the wait yourself
* [Cancel a run](/agent/guides/cancel-a-run): best-effort cancellation, and why it can lose the race to completion
* [Reference](/agent/reference): endpoints, fields, limits and errors
* [Agent API Reference](/api-reference/agent/list-runs): full REST request and response specification