--- title: "List upcoming tasks" method: GET path: "/v2/tasks" tags: ["Tasks"] --- # List upcoming tasks `GET /v2/tasks` ## Request - Base URL: `https://api.streak.com/api` - URL: `https://api.streak.com/api/v2/tasks` - Auth: HTTP bearer Lists tasks across all pipelines and boxes. By default, returns incomplete tasks assigned to the current user before tomorrow in the user's timezone, which includes today's and overdue tasks. Use userKeys, pipelineKey, includeCompleted, direction, limit, and sortOrder to page through other agenda slices. ## Query parameters - `direction` string, nullable - `includeCompleted` boolean - `limit` integer - `pipelineKey` string, nullable - `sortOrder` string, nullable - `userKeys` string[], nullable ## Response `200` OK - TaskListResponseWithPaging: A page of Task(s), with an optional continuation cursor. - `hasNextPage` boolean: Whether another page is available. A page can be empty after permission filtering even when this is true. - `results` Task[], required: The Task(s) returned by this response, in result order. - `key` string, required: Key for this task. - `boxKey` string, required: Key for the box this task belongs to. - `pipelineKey` string, required: Key for the pipeline this task belongs to. - `creatorKey` string, required: Key for the user who created this task. - `creator` UserBrief, required - `userKey` string, required: Key for this user. - `email` string, nullable: User email address, when available. - `displayName` string, nullable: Short display name for this user, when available. - `fullName` string, nullable: Full display name for this user, when available. - `givenName` string, nullable: Given name for this user, when available. - `avatarUrl` string, nullable: Avatar image URL for this user, when available. - `assignedTo` UserBrief[], required: Users assigned to this task. Tasks created without explicit assignees are assigned to the creator by default. - `userKey` string, required: Key for this user. - `email` string, nullable: User email address, when available. - `displayName` string, nullable: Short display name for this user, when available. - `fullName` string, nullable: Full display name for this user, when available. - `givenName` string, nullable: Given name for this user, when available. - `avatarUrl` string, nullable: Avatar image URL for this user, when available. - `creationDate` integer, required: Timestamp when this task was created, in epoch milliseconds. - `lastSavedTimestamp` integer, required: Timestamp when this task was last persisted, in epoch milliseconds. - `lastStatusChangeDate` integer, required: Timestamp when this task status last changed, in epoch milliseconds. - `dueDate` integer, nullable: Task due date, in epoch milliseconds. - `text` string, required: Task text. - `actions` TaskAction[], nullable: Suggested actions inferred from the task text. - `type` 'EMAIL' | 'SCHEDULE' | 'CALL' | 'FOLLOW_UP', required - `value` string, required: Suggested action value, such as an email address or phone number. - `contact` Contact, required: A contact shared with the team. - `key` string, required: Stable key for this contact. - `teamKey` string, required: Key for the team that owns this contact. - `givenName` string, nullable: Given name of the contact. - `familyName` string, nullable: Family name of the contact. - `other` string, nullable: Notes about the contact. - `title` string, nullable: Job title of the contact. - `emailAddresses` string[], required: Normalized email addresses with duplicates removed, in first-occurrence order. - `phoneNumbers` string[], required: Phone numbers with duplicates and null entries removed, in first-occurrence order. - `addresses` string[], required: Postal addresses with duplicates and null entries removed, in first-occurrence order. - `domains` string[], required: Website domains associated with the contact. - `normalizedDomains` string[], required: Stored normalized domains used to match organizations. - `twitterHandle` string, nullable: Twitter profile handle. - `facebookHandle` string, nullable: Facebook profile handle. - `linkedinHandle` string, nullable: LinkedIn profile handle. - `instagramHandle` string, nullable: Instagram profile handle. - `photoUrl` string, nullable: URL of the contact profile image. - `lastSavedUserKey` string, nullable: Key for the user who last edited this record. - `creatorKey` string, nullable: Key for the user who created this record. - `creationDate` integer, nullable: Time this record was first created, in epoch milliseconds. - `versionTimestamp` integer, nullable: Time this version of the record was created, in epoch milliseconds. - `lastSavedTimestamp` integer, nullable: Time this record was last saved, in epoch milliseconds. - `lastEnrichmentTimestamp` integer, nullable: Time enrichment was last applied or reviewed, in epoch milliseconds. - `contactLinks` ContactLink[], required: Contacts linked to this record, in their stored order. - `key` string, required: Key for the linked contact. - `isMagicLinked` boolean: Whether Streak linked this record automatically. - `creationTimestamp` integer, nullable: Time the relationship was created, in epoch milliseconds. - `orgLinks` OrganizationLink[], required: Organizations linked to this record, in their stored order. - `key` string, required: Stable key for the linked organization. - `isMagicLinked` boolean: Whether Streak linked this record automatically. - `creationTimestamp` integer, nullable: Time the relationship was created, in epoch milliseconds. - `fields` object, required: Custom field values keyed by field identifier. - `status` 'NOT_DONE' | 'DONE', required - `reminderStatus` 'NONE' | 'SCHEDULED' | 'REMINDED' | 'ERROR_ON_REMINDER' | 'NOT_REMINDED_BECAUSE_TASK_DONE', required - `meetingKey` string, nullable: Key for the meeting this task belongs to, when any. - `cursor` string, nullable: Continuation cursor for endpoints that use cursor pagination. Pass it as cursor to request the next page. Omitted for page-number pagination and when no continuation cursor remains. ## Changes - **2026-10-16** `1c3a5ef8b9ea`: 1 info - endpoint added [Operation history](https://skmtc.dev/streakyc/apis/streak/changes/v2/tasks/get.md) --- [API](https://skmtc.dev/streakyc/apis/streak.md) - [All operations](https://skmtc.dev/streakyc/apis/streak/llms.txt) - [OpenAPI document](https://skmtc.dev/streakyc/apis/streak/revisions/3648671fd1cf?raw)