---
title: "List all todos"
method: GET
path: "/orgs/{orgId}/projects/{projectId}/scout/todos"
tags: ["Todos"]
---

# List all todos

`GET /orgs/{orgId}/projects/{projectId}/scout/todos`

## Path parameters

- `orgId` string, required
- `projectId` string, required

## Query parameters

- `after` string — Use the `endCursor` as a value for the `after` parameter to get the next page.
- `before` string — Use the `startCursor` as a value for the `before` parameter to get the next page.
- `sort` string — This list is currently not sortable by other properties. It is sorted by the id descending (`-id`) by default. To reverse the sort order, use `id` as the value.
- `filter` string — Filters the collection items. This field requires a special format. For more information, see [Using filter with collections](#section/Using-filter-with-collections).
- `limit` integer — Use to return a number of results per page. If there is more data, use in combination with `after` to page through the data.

## Headers

- `x-redocly-scout-version` string

## Response `200`

OK.

- JobList
  - `object` 'list', required
  - `page` Page, required
    - `endCursor` string, nullable, required — Use with the `after` query parameter to load the next page of data. When `null`, there is no data. The cursor is opaque and internal structure is subject to change.
    - `startCursor` string, nullable, required — Use with the `before` query parameter to load the previous page of data. When `null`, there is no data. The cursor is opaque and internal structure is subject to change.
    - `hasNextPage` boolean, required — Indicates if there is a next page with items.
    - `hasPrevPage` boolean, required — Indicates if there is a previous page with items.
    - `limit` integer, required — Value showing how many items are in the page limit.
    - `total` integer, required — Count of items across all pages.
  - `items` Job[], required
    - `id` string, ulid, required — ID of the job.
    - `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED', required — Job status.
    - `type` 'PROCESS_GIT_REPO' | 'UPDATE_STATUS', required — Type of job.
    - `organizationId` string, required — Organization ID.
    - `projectId` string, required — Project ID.
    - `providerId` string — Git provider identifier (appId for GitHub).
    - `providerType` 'GITHUB_CLOUD' | 'GITHUB_SERVER' | 'GITLAB_CLOUD' | 'GITLAB_SELF_MANAGED' | 'BITBUCKET_CLOUD' | 'BITBUCKET_DATACENTER' | 'AZURE', required — Git provider type.
    - `namespaceId` string, required — Git repo namespace id (organization login for GitHub).
    - `repositoryId` string, required — Git repo id.
    - `branch` string, required — Git branch name.
    - `commitSha` string, required — Git commit SHA.
    - `isMainBranch` boolean — True if branch is main.
    - `prId` string — Git pull request ID.
    - `attempts` integer, required — Number of attempts to process the job.
    - `parentJobId` string, ulid — ID of the parent job, if any.
    - `checks` GitCommitCheck[] — Commit status checks.
      - `name` string, required — Check name.
      - `status` 'IN_PROGRESS' | 'SUCCESS' | 'FAILED', required — Git commit status.
      - `description` string — Git commit status description.
      - `targetUrl` string — Git commit status target URL.
    - `metadata` JobMetadata — Additional information about job.
      - `scoutVersion` string — Scout version.
      - `errorMessage` string — Error message, if any.
      - `errorStack` string — Error stack trace, if any.
    - `startedAt` string, date-time — Job start date.
    - `createdAt` string, date-time, required — Job creation date.
    - `updatedAt` string, date-time, required — Job last update date.

## Other responses

- `400` — Bad Request.

---

[API](https://skmtc.net/redocly/apis/redocly-scout.md) · [All operations](https://skmtc.net/redocly/apis/redocly-scout/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/redocly/redocly-scout/revisions/193cacd75700/schema)