> ## Documentation Index > Fetch the complete documentation index at: https://docs.heffl.com/llms.txt > Use this file to discover all available pages before exploring further. # List tasks > Returns a paginated list of tasks. Supports cursor pagination, full-text search, structured filters (status, type, priority, assignees, tags, dates), and sorting. Results respect the API key user's permissions. See the [Listing & filters](/api-v2/listing-and-filters) guide for filter syntax. ## OpenAPI ````yaml /openapi.v2.json get /tasks openapi: 3.1.1 info: title: Heffl API v2 (Beta) version: 2.0.0 description: >- Heffl REST API v2 (beta) — resource-oriented endpoints with consistent response envelopes. Endpoints, schemas, and behavior may change until GA. See Agent workflows and ID prefixes guides for automation. contact: name: Heffl Support url: https://heffl.com/support email: support@heffl.com servers: - url: https://api.heffl.com/api/v2 description: Production API Server security: - ApiKeyAuth: [] paths: /tasks: get: tags: - Objects summary: List tasks description: >- Returns a paginated list of tasks. Supports cursor pagination, full-text search, structured filters (status, type, priority, assignees, tags, dates), and sorting. Results respect the API key user's permissions. See the [Listing & filters](/api-v2/listing-and-filters) guide for filter syntax. operationId: objects.tasks.list parameters: - name: cursor in: query required: false schema: type: string description: >- Cursor for pagination. Pass the previous response meta.nextCursor value to fetch the next page. - name: pageSize in: query required: false schema: type: integer minimum: 1 maximum: 100 default: 30 description: Number of items to return per page (max 100) - name: search in: query required: false schema: type: string description: Search by title, number, or description - name: orderBy in: query required: false schema: type: string enum: - createdAt - dueDate - startDate - number - title default: createdAt description: Field to sort results by - name: orderDir in: query required: false schema: type: string enum: - asc - desc default: desc description: Sort direction - name: filters in: query required: false schema: type: object description: >- Structured filters. Each key is a filter field with operator and values. Option fields use string IDs; date fields use ISO 8601 date-time strings. See the Listing & filters guide. properties: status: type: object properties: operator: type: string enum: - is - is_not - is_any_of - is_none_of values: type: array items: type: string enum: - OPEN - IN_PROGRESS - ON_HOLD - COMPLETED - CANCELLED type: type: object properties: operator: type: string enum: - is - is_not - is_any_of - is_none_of values: type: array items: type: string enum: - call - todo - meeting priority: type: object properties: operator: type: string enum: - is - is_not - is_any_of - is_none_of values: type: array items: type: string enum: - LOW - MEDIUM - HIGH createdById: type: object properties: operator: type: string enum: - is - is_not - is_any_of - is_none_of values: type: array items: type: string description: Creator user ID (e.g. usr_abc123) assigneeIds: type: object properties: operator: type: string enum: - include - exclude - include_any_of - include_all_of - exclude_if_any_of - exclude_if_all values: type: array items: type: string description: Assignee user ID (e.g. usr_abc123) tagIds: type: object properties: operator: type: string enum: - include - exclude - include_any_of - include_all_of - exclude_if_any_of - exclude_if_all values: type: array items: type: string description: Tag ID (e.g. tag_abc123) createdAt: type: object properties: operator: type: string enum: - is - is_not - is_before - is_after - is_on_or_before - is_on_or_after - is_between - is_not_between values: type: array items: type: string format: date-time startDate: type: object properties: operator: type: string enum: - is - is_not - is_before - is_after - is_on_or_before - is_on_or_after - is_between - is_not_between values: type: array items: type: string format: date-time dueDate: type: object properties: operator: type: string enum: - is - is_not - is_before - is_after - is_on_or_before - is_on_or_after - is_between - is_not_between values: type: array items: type: string format: date-time style: deepObject explode: true responses: '200': description: OK content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/Task' meta: $ref: '#/components/schemas/ListMeta' required: - data - meta '400': description: Validation error or bad request content: application/json: schema: $ref: '#/components/schemas/V2ApiError' '401': description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/V2ApiError' '403': description: Insufficient permission content: application/json: schema: $ref: '#/components/schemas/V2ApiError' '404': description: Resource not found content: application/json: schema: $ref: '#/components/schemas/V2ApiError' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/V2ApiError' components: schemas: Task: type: object properties: id: type: string description: Task ID number: type: string description: Auto-generated task number title: type: string description: Task title description: anyOf: - type: string - type: 'null' description: Task description status: type: string enum: - OPEN - IN_PROGRESS - ON_HOLD - COMPLETED - CANCELLED description: Task status type: type: string enum: - call - todo - meeting description: Task type priority: anyOf: - type: string enum: - LOW - MEDIUM - HIGH - type: 'null' description: Task priority dueDate: anyOf: - type: string format: date-time - type: 'null' description: Due date startDate: anyOf: - type: string format: date-time - type: 'null' description: Start date showTime: type: boolean description: Whether to show time on the due date durationMinutes: anyOf: - type: number - type: 'null' description: Duration in minutes completedOn: anyOf: - type: string format: date-time - type: 'null' description: When the task was completed entity: anyOf: - type: string enum: - projects - leads - deals - type: 'null' description: Linked entity type entityId: anyOf: - type: string - type: 'null' description: Linked entity ID projectId: anyOf: - type: string - type: 'null' description: Linked project ID leadId: anyOf: - type: string - type: 'null' description: Linked lead ID dealId: anyOf: - type: string - type: 'null' description: Linked deal ID clientId: anyOf: - type: string - type: 'null' description: Linked client ID contactId: anyOf: - type: string - type: 'null' description: Linked contact ID assigneeIds: type: array items: type: string description: Assignee user IDs tagIds: type: array items: type: string description: Tag IDs createdById: anyOf: - type: string - type: 'null' description: Creator user ID createdByName: anyOf: - type: string - type: 'null' description: Creator name createdAt: anyOf: - type: string format: date-time - type: 'null' description: When the task was created updatedAt: anyOf: - type: string format: date-time - type: 'null' description: When the task was last updated required: - id - number - title - status - type - showTime - assigneeIds - tagIds additionalProperties: description: >- Custom field values as top-level cf_* keys (for example cf_follow_up_type). There is no customFields wrapper. ListMeta: type: object properties: nextCursor: type: - string - 'null' description: Cursor to fetch the next page. Null if there are no more results. hasMore: type: boolean description: Whether additional results are available required: - hasMore V2ApiError: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string message: type: string details: type: object securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- API key for authentication. Get yours at app.heffl.com/settings/developers ````