---
title: "GET /v1/Workspaces/{WorkspaceSid}/Tasks"
method: GET
path: "/v1/Workspaces/{WorkspaceSid}/Tasks"
tags: ["TaskrouterV1Task"]
---

# GET /v1/Workspaces/{WorkspaceSid}/Tasks

`GET /v1/Workspaces/{WorkspaceSid}/Tasks`

## Path parameters

- `WorkspaceSid` string, required

## Query parameters

- `Priority` integer
- `AssignmentStatus` string[]
- `WorkflowSid` string
- `WorkflowName` string
- `TaskQueueSid` string
- `TaskQueueName` string
- `EvaluateTaskAttributes` string
- `RoutingTarget` string
- `Ordering` string
- `HasAddons` boolean
- `PageSize` integer
- `Page` integer
- `PageToken` string

## Response `200`

OK

- object
  - `tasks` TaskrouterV1WorkspaceTask[]
    - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Task resource.
    - `age` integer — The number of seconds since the Task was created.
    - `assignment_status` 'pending' | 'reserved' | 'assigned' | 'canceled' | 'completed' | 'wrapping' — The current status of the Task's assignment. Can be: `pending`, `reserved`, `assigned`, `canceled`, `wrapping`, or `completed`.
    - `attributes` string, nullable — The JSON string with custom attributes of the work. **Note** If this property has been assigned a value, it will only be displayed in FETCH action that returns a single resource. Otherwise, it will be null.
    - `addons` string, nullable — An object that contains the [Add-on](https://www.twilio.com/docs/add-ons) data for all installed Add-ons.
    - `date_created` string, date-time, nullable — The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `date_updated` string, date-time, nullable — The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `task_queue_entered_date` string, date-time, nullable — The date and time in GMT when the Task entered the TaskQueue, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `priority` integer — The current priority score of the Task as assigned to a Worker by the workflow. Tasks with higher priority values will be assigned before Tasks with lower values.
    - `reason` string, nullable — The reason the Task was canceled or completed, if applicable.
    - `sid` string, nullable — The unique string that we created to identify the Task resource.
    - `task_queue_sid` string, nullable — The SID of the TaskQueue.
    - `task_queue_friendly_name` string, nullable — The friendly name of the TaskQueue.
    - `task_channel_sid` string, nullable — The SID of the TaskChannel.
    - `task_channel_unique_name` string, nullable — The unique name of the TaskChannel.
    - `timeout` integer — The amount of time in seconds that the Task can live before being assigned.
    - `workflow_sid` string, nullable — The SID of the Workflow that is controlling the Task.
    - `workflow_friendly_name` string, nullable — The friendly name of the Workflow that is controlling the Task.
    - `workspace_sid` string, nullable — The SID of the Workspace that contains the Task.
    - `url` string, uri, nullable — The absolute URL of the Task resource.
    - `links` object, nullable — The URLs of related resources.
    - `virtual_start_time` string, date-time, nullable — The date and time in GMT indicating the ordering for routing of the Task specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `ignore_capacity` boolean, nullable — A boolean that indicates if the Task should respect a Worker's capacity and availability during assignment. This field can only be used when the `RoutingTarget` field is set to a Worker SID. By setting `IgnoreCapacity` to a value of `true`, `1`, or `yes`, the Task will be routed to the Worker without respecting their capacity and availability. Any other value will enforce the Worker's capacity and availability. The default value of `IgnoreCapacity` is `true` when the `RoutingTarget` is set to a Worker SID.
    - `routing_target` string, nullable — A SID of a Worker, Queue, or Workflow to route a Task to
  - `meta` object
    - `first_page_url` string, uri
    - `key` string
    - `next_page_url` string, uri, nullable
    - `page` integer
    - `page_size` integer
    - `previous_page_url` string, uri, nullable
    - `url` string, uri

## Changes

- **2025-02-20** (v1) `d59ca09cbb02` — 1 breaking
  - for the `query` request parameter `PageSize`, the type/format was changed from `integer`/`` to `integer`/`int64`
- **2024-08-26** (v1) `98cb7b6f5a62` — 3 info
  - the `age` response's property default value `0` was added for the status `200`
  - the `priority` response's property default value `0` was added for the status `200`
  - the `timeout` response's property default value `0` was added for the status `200`
- **2024-05-24** (v1) `5869dc743a72` — 3 info
  - added the new optional `query` request parameter `RoutingTarget`
  - added the optional property `tasks/items/ignore_capacity` to the response with the `200` status
  - added the optional property `tasks/items/routing_target` to the response with the `200` status
- **2023-10-19** (v1) `fe8d27521111` — 1 info
  - added the optional property `tasks/items/virtual_start_time` to the response with the `200` status
- **2023-08-10** (v1) `0dff2919dfba` — 1 info
  - api tag `TaskrouterV1Task` added

[Full history](https://skmtc.dev/twilio/apis/taskrouter-v1/changes/v1/Workspaces/:WorkspaceSid/Tasks/get.md)

---

[API](https://skmtc.dev/twilio/apis/taskrouter-v1.md) · [All operations](https://skmtc.dev/twilio/apis/taskrouter-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/taskrouter-v1/revisions/f431d2bc66ba/schema)