---
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
- `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, nullable — The number of seconds since the Task was created.
    - `assignment_status` 'pending' | 'reserved' | 'assigned' | 'canceled' | 'completed' | 'wrapping'
    - `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 [addon](https://www.twilio.com/docs/taskrouter/marketplace) data for all installed addons.
    - `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, nullable — 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, nullable — 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.
  - `meta` object
    - `first_page_url` string, uri
    - `next_page_url` string, uri, nullable
    - `page` integer
    - `page_size` integer
    - `previous_page_url` string, uri, nullable
    - `url` string, uri
    - `key` string

## Changes

- **2023-08-10** (v1) `0dff2919dfba` — 1 info
  - api tag `TaskrouterV1Task` added
- **2023-02-02** (v1) `e7c84908f046` — 2 info
  - added the new optional `query` request parameter `Page`
  - added the new optional `query` request parameter `PageToken`

[Change 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/0dff2919dfba/schema)
