---
title: "List tasks"
method: GET
path: "/tasks"
tags: ["Tasks"]
---

# List tasks

`GET /tasks`

## Request

- Base URL: `https://www.ruddr.io/api/workspace`
- URL: `https://www.ruddr.io/api/workspace/tasks`
- Auth: HTTP bearer

## Query parameters

- `startingAfter` string
- `endingBefore` string
- `limit` integer
- `modifiedAtAfter` union
  - string, date
  - string, date-time
- `modifiedAtOnAfter` union
  - string, date
  - string, date-time
- `modifiedAtBefore` union
  - string, date
  - string, date-time
- `modifiedAtOnBefore` union
  - string, date
  - string, date-time
- `projectId` string
- `code` string
- `name` string
- `nameContains` string
- `nameStartsWith` string
- `nameEndsWith` string

## Response `200`

200

- object
  - `results` Task[]: The list of results for the current page.
    - `id` string: The unique identifier for the object.
    - `name` string: The name of the task.
    - `notes` string, nullable: Any notes associated with the task.
    - `order` integer: The display order position of the task (same value as `position`).
    - `position` integer: The numeric position of the task used for ordering.
    - `statusId` 'not_started' | 'in_progress' | 'completed': The status of the task.
    - `start` string, date, nullable: The start date for the task. Will be in the form YYYY-MM-DD.
    - `end` string, date, nullable: The end date for the task. Will be in the form YYYY-MM-DD. `null` if no end date is set.
    - `isBillable` boolean: Whether the task is billable. Overridden to `false` when the project is not billable.
    - `lockTime` boolean: When enabled, prevents new time entries from being created with this task.
    - `capHours` boolean: When enabled, prevents time entries that would exceed the budgeted hours for this task.
    - `capAssignedHours` boolean: When enabled, prevents time entries that would exceed the budgeted hours assigned to the role or member for this task.
    - `code` string, nullable: The task code.
    - `forAssignedOnly` boolean: When enabled, only assigned members and roles can track time to this task.
    - `requireNotes` boolean: Whether notes are required on time entries for this task. Overridden to `true` when the project requires notes.
    - `recordStatusId` 'active' | 'archived': The record status of the task.
    - `budgetedHours` number, nullable: The budgeted hours for the task.
    - `budgetedServicesRevenue` number, nullable: The budgeted services revenue for the task.
    - `createdAt` string, date-time: The timestamp when the object was created.
    - `modifiedAt` string, date-time: The timestamp when the object was last modified.
    - `project` object: The project this task belongs to.
      - `id` string: The unique identifier for the object.
      - `name` string: The name of the project.
      - `client` object: The client associated with the project.
        - `id` string: The unique identifier for the object.
        - `name` string: The name of the client.
    - `parent` object, nullable: The parent task this task is nested under, or `null` if it has no parent.
      - `id` string: The unique identifier for the object.
      - `name` string: The name of the parent task.
    - `roles` object[], nullable: The list of project roles assigned to this task. `null` when the project does not use roles.
      - `id` string: The unique identifier for the object.
      - `name` string: The name of the project role.
      - `hours` number, nullable: The budgeted hours allocated to this role for the task.
    - `projectMembers` object[]: The list of project members directly assigned to this task.
      - `id` string: The unique identifier for the object.
      - `member` object: The member associated with the project member assignment.
        - `id` string: The unique identifier for the object.
        - `name` string: The full name of the member.
      - `hours` number, nullable: The budgeted hours allocated to this member for the task. `null` when the project uses roles.
    - `tags` object[]: The list of tags associated with this task.
      - `id` string: The unique identifier for the object.
      - `name` string: The name of the tag.
    - `taskCategory` object: The task category associated with this task.
      - `id` string: The unique identifier for the object.
      - `name` string: The name of the task category.
      - `type` 'standard' | 'rollup' | 'milestone': The type of the task category.
    - `predecessors` object[], nullable: The tasks that must finish before this task can start. `null` when `useDependencies` is disabled on the project.
      - `id` string: The unique identifier for the object.
      - `name` string: The name of the predecessor task.
    - `successors` object[], nullable: The tasks that cannot start until this task finishes. `null` when `useDependencies` is disabled on the project.
      - `id` string: The unique identifier for the object.
      - `name` string: The name of the successor task.
  - `hasMore` boolean: Whether there are more results available after this page.

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/ruddr/apis/ruddr-api.md) · [All operations](https://skmtc.dev/ruddr/apis/ruddr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ruddr/apis/ruddr-api/revisions/01c3f2a969ba?raw)