---
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`

## Request

- Base URL: `https://app.cloud.redocly.com/api`
- URL: `https://app.cloud.redocly.com/api/orgs/{orgId}/projects/{projectId}/scout/todos`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/redocly/apis/redocly-scout/docs/orgs/:orgId/projects/:projectId/scout/todos/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

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

## Query parameters

- `after` string: Use the `nextPage` cursor as a value for the `after` parameter to get the next page.
- `before` string: Use the `previousPage` cursor as a value for the `before` parameter to get the previous 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
    - `nextPage` string, nullable, required: Use with the `after` query parameter to load the next page of data. When `null`, there is no next page. The cursor is opaque and internal structure is subject to change.
    - `previousPage` string, nullable, required: Use with the `before` query parameter to load the previous page of data. When `null`, there is no previous page. The cursor is opaque and internal structure is subject to change.
    - `limit` integer, required: Value showing how many items are in the page limit.
  - `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: Organization ID.
    - `projectId` string: 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.

## Changes

- **2026-09-18** `18944395275b`: 1 breaking
  - removed the required property `page/total` from the response with the `200` status
- **2026-08-31** `af21e29b69cc`: 4 breaking, 2 info
  - removed the required property `page/endCursor` from the response with the `200` status
  - removed the required property `page/hasNextPage` from the response with the `200` status
  - removed the required property `page/hasPrevPage` from the response with the `200` status
  - removed the required property `page/startCursor` from the response with the `200` status
  - …2 more
- **2026-08-21** `5dc606d075e4`: 2 breaking
  - the response property `items/items/organizationId` became optional for the status `200`
  - the response property `items/items/projectId` became optional for the status `200`

[Operation history](https://skmtc.dev/redocly/apis/redocly-scout/changes/orgs/:orgId/projects/:projectId/scout/todos/get.md)

---

[API](https://skmtc.dev/redocly/apis/redocly-scout.md) - [All operations](https://skmtc.dev/redocly/apis/redocly-scout/llms.txt) - [OpenAPI document](https://skmtc.dev/redocly/apis/redocly-scout/revisions/18944395275b?raw)