> ## Documentation Index > Fetch the complete documentation index at: https://docs.unifygtm.com/llms.txt > Use this file to discover all available pages before exploring further. # List tasks > List tasks, optionally filtered by status, type, priority, assignee, or person. ## OpenAPI ````yaml GET /tasks openapi: 3.1.0 info: title: Unify Tasks API summary: List and manage tasks within the Unify platform. version: '1' termsOfService: https://www.unifygtm.com/legal/terms-and-conditions contact: name: Unify Support url: https://www.unifygtm.com/support email: support@unifygtm.com servers: - url: https://api.unifygtm.com/tasks/v1 variables: {} security: - ApiKeyAuth: [] tags: - name: Tasks paths: /tasks: get: tags: - Tasks description: >- By default, list tasks by `created_at` descending, with `id` descending for tasks created at the same time. Supply the returned `next_cursor` unchanged to retrieve the next page with the same filters and sort order. operationId: list_tasks parameters: - name: cursor in: query required: false description: Opaque cursor returned by the previous page. schema: type: string explode: false - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 100 explode: false - name: sort_by in: query required: false description: Field to sort by. Defaults to `created_at`. schema: $ref: '#/components/schemas/TaskSortField' explode: false - name: sort_order in: query required: false description: Sort direction. Defaults to descending. schema: $ref: '#/components/schemas/SortOrder' explode: false - name: status in: query required: false description: Filter tasks by status. schema: $ref: '#/components/schemas/TaskStatus' explode: false - name: assigned_user_id in: query required: false description: Filter tasks by assignee. schema: $ref: '#/components/schemas/uuid' explode: false - name: person_id in: query required: false description: Filter tasks by person. schema: $ref: '#/components/schemas/uuid' explode: false - name: person_email in: query required: false description: >- Filter tasks by the person's exact email address. Cannot be combined with `person_id`. Email matching is case-insensitive. schema: $ref: '#/components/schemas/email' explode: false responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/ListTasksResponse' '400': description: Response for any operation that results in a bad request error. content: application/json: schema: type: object required: - status properties: status: type: string enum: - bad_request errors: type: array items: $ref: '#/components/schemas/UResponses.BadRequestError' message: type: string description: >- Response for any operation that results in a bad request error. '401': description: Response for any operation that results in an unauthorized error. content: application/json: schema: type: object required: - status - message properties: status: type: string enum: - unauthorized message: type: string description: >- Response for any operation that results in an unauthorized error. '403': description: Response for any operation that results in a forbidden error. content: application/json: schema: type: object required: - status - message properties: status: type: string enum: - forbidden message: type: string description: Response for any operation that results in a forbidden error. '429': description: Response for any operation that exceeds a rate limit. content: application/json: schema: type: object required: - status - message properties: status: type: string enum: - rate_limited message: type: string description: Response for any operation that exceeds a rate limit. '500': description: Response for any operation that results in an internal server error. content: application/json: schema: type: object required: - status - message properties: status: type: string enum: - error message: type: string description: >- Response for any operation that results in an internal server error. components: schemas: TaskSortField: type: string enum: - created_at SortOrder: type: string enum: - asc - desc TaskStatus: type: string enum: - NOT_READY - READY - COMPLETED - SKIPPED - CANCELED uuid: type: string format: uuid email: type: string format: email ListTasksResponse: type: object required: - status - data - next_cursor properties: status: type: string enum: - success data: type: array items: $ref: '#/components/schemas/Task' next_cursor: anyOf: - type: string - type: 'null' description: >- Opaque cursor for the next page, or null when there are no more tasks. UResponses.BadRequestError: type: object required: - code properties: code: type: string path: type: array items: anyOf: - type: string - type: integer object_api_name: type: string attribute_api_name: type: string allOf: - type: object unevaluatedProperties: {} description: Validation error detail returned for bad request responses. Task: type: object required: - id - type - status - priority - person_id - assigned_user_id - due_at - ended_at - created_at - updated_at properties: id: $ref: '#/components/schemas/uuid' type: $ref: '#/components/schemas/TaskType' status: $ref: '#/components/schemas/TaskStatus' priority: $ref: '#/components/schemas/TaskPriority' person_id: $ref: '#/components/schemas/uuid' assigned_user_id: anyOf: - $ref: '#/components/schemas/uuid' - type: 'null' due_at: anyOf: - type: string format: date-time - type: 'null' ended_at: anyOf: - type: string format: date-time - type: 'null' note_content: anyOf: - type: string - type: 'null' created_at: type: string format: date-time updated_at: type: string format: date-time TaskType: type: string enum: - EMAIL - ACTION_ITEM - PHONE_CALL - LINKEDIN_SEND_MESSAGE - LINKEDIN_SEND_CONNECTION_REQUEST - LINKEDIN_VIEW_PROFILE - REPLY_TO_EMAIL TaskPriority: type: string enum: - LOW - MEDIUM - HIGH - URGENT securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key ````