List tasks

curl --request GET \
  --url https://client-api.salesfinity.co/v2/sequencer/tasks \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://client-api.salesfinity.co/v2/sequencer/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client-api.salesfinity.co/v2/sequencer/tasks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://client-api.salesfinity.co/v2/sequencer/tasks"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://client-api.salesfinity.co/v2/sequencer/tasks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "_id": "66fd2a91c3e4b5a6d7e8f901",
      "team": "64b7f0c2e4b0a1b2c3d4e5f0",
      "user": {
        "_id": "64b7f0c2e4b0a1b2c3d4e5f1",
        "first_name": "Dana",
        "last_name": "Reyes",
        "email": "[email protected]"
      },
      "sequence": {
        "_id": "66f0aa11b2c3d4e5f6a7b8c1",
        "name": "Q4 outbound: VP Sales"
      },
      "sequence_state": "66fb3c22d4e5f6a7b8c9d0e1",
      "sequence_step": {
        "_id": "66f0aa11b2c3d4e5f6a7b8d3",
        "order": 2,
        "step_type": "call",
        "display_name": "Intro call"
      },
      "contact": {
        "_id": "66f9b1e0a2c3d4e5f6a7b8c9",
        "first_name": "Theresa",
        "last_name": "Webb",
        "email": "[email protected]",
        "account": "Acme, LLC",
        "account_key": "acme",
        "title": "VP of Sales",
        "timezone": "America/Chicago",
        "phone_numbers": [
          {
            "type": "direct",
            "number": "+15125550142",
            "do_not_call": false
          }
        ],
        "last_touched_at": "2026-09-30T15:12:04.000Z"
      },
      "origin": "sequence",
      "action": "call",
      "subject": "Intro call",
      "note": "Reference the Q3 pipeline report she downloaded.",
      "due_at": "2026-10-03T14:00:00.000Z",
      "priority": "high",
      "autoskip_at": "2026-10-06T14:00:00.000Z",
      "state": "pending",
      "held_at": null,
      "standalone": false,
      "contact_list": "66fc0d44e5f6a7b8c9d0e1f2",
      "contact_list_item": "66fd2a92c3e4b5a6d7e8f9aa",
      "sending_claimed_at": null,
      "outcome_applied_at": null,
      "created_at": "2026-10-03T14:00:01.000Z",
      "updated_at": "2026-10-03T14:00:03.000Z"
    }
  ],
  "pagination": {
    "total": 37,
    "page": 1,
    "limit": 25,
    "pages": 2
  }
}

{
  "message": [
    "limit must not be greater than 100"
  ],
  "error": "Bad Request",
  "statusCode": 400,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Forbidden resource",
  "error": "Forbidden",
  "statusCode": 403,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Rate limit of 300 requests per minute exceeded. Retry in 12s.",
  "error": "Too Many Requests",
  "statusCode": 429,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Internal server error",
  "error": "Internal Server Error",
  "statusCode": 500,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service unreachable",
  "error": "Bad Gateway",
  "statusCode": 502,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service timed out",
  "error": "Gateway Timeout",
  "statusCode": 504,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

Tasks

List tasks

Returns a page of the team’s Sequencer tasks: the calls, emails and to-dos that sequence steps and reactions created, plus one-off tasks reps created.

With no filters it returns every assignee’s tasks in every state, oldest due first. Send state=pending for the working queue, and add action=call for the call queue or overdue=true for what is late.

Filters combine. overdue=true and due_before both bound due_at, and the earlier bound wins. search matches the contact’s first name, last name, email or company, and is ignored when contact is set.
Sorting is server-side, across the whole result set. Sorts other than due rank at most 2,000 matching tasks, so narrow the set first when it could be larger.
Expanded fields. Each task carries contact (name, email, company, title, phone numbers, timezone and CRM facts), sequence (_id, name) and sequence_step (_id, order, step_type, display_name) as objects. With sort=due, user is expanded to the assignee’s _id, first_name, last_name, email and image; other sorts return the assignee’s id.

Reads act as the team owner, so they cover the whole team. For counts without rows, use GET /v2/sequencer/tasks/summary. Counts against the Sequencer reads rate limit.

GET

sequencer

tasks

List tasks

curl --request GET \
  --url https://client-api.salesfinity.co/v2/sequencer/tasks \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://client-api.salesfinity.co/v2/sequencer/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client-api.salesfinity.co/v2/sequencer/tasks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://client-api.salesfinity.co/v2/sequencer/tasks"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://client-api.salesfinity.co/v2/sequencer/tasks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "_id": "66fd2a91c3e4b5a6d7e8f901",
      "team": "64b7f0c2e4b0a1b2c3d4e5f0",
      "user": {
        "_id": "64b7f0c2e4b0a1b2c3d4e5f1",
        "first_name": "Dana",
        "last_name": "Reyes",
        "email": "[email protected]"
      },
      "sequence": {
        "_id": "66f0aa11b2c3d4e5f6a7b8c1",
        "name": "Q4 outbound: VP Sales"
      },
      "sequence_state": "66fb3c22d4e5f6a7b8c9d0e1",
      "sequence_step": {
        "_id": "66f0aa11b2c3d4e5f6a7b8d3",
        "order": 2,
        "step_type": "call",
        "display_name": "Intro call"
      },
      "contact": {
        "_id": "66f9b1e0a2c3d4e5f6a7b8c9",
        "first_name": "Theresa",
        "last_name": "Webb",
        "email": "[email protected]",
        "account": "Acme, LLC",
        "account_key": "acme",
        "title": "VP of Sales",
        "timezone": "America/Chicago",
        "phone_numbers": [
          {
            "type": "direct",
            "number": "+15125550142",
            "do_not_call": false
          }
        ],
        "last_touched_at": "2026-09-30T15:12:04.000Z"
      },
      "origin": "sequence",
      "action": "call",
      "subject": "Intro call",
      "note": "Reference the Q3 pipeline report she downloaded.",
      "due_at": "2026-10-03T14:00:00.000Z",
      "priority": "high",
      "autoskip_at": "2026-10-06T14:00:00.000Z",
      "state": "pending",
      "held_at": null,
      "standalone": false,
      "contact_list": "66fc0d44e5f6a7b8c9d0e1f2",
      "contact_list_item": "66fd2a92c3e4b5a6d7e8f9aa",
      "sending_claimed_at": null,
      "outcome_applied_at": null,
      "created_at": "2026-10-03T14:00:01.000Z",
      "updated_at": "2026-10-03T14:00:03.000Z"
    }
  ],
  "pagination": {
    "total": 37,
    "page": 1,
    "limit": 25,
    "pages": 2
  }
}

{
  "message": [
    "limit must not be greater than 100"
  ],
  "error": "Bad Request",
  "statusCode": 400,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Forbidden resource",
  "error": "Forbidden",
  "statusCode": 403,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Rate limit of 300 requests per minute exceeded. Retry in 12s.",
  "error": "Too Many Requests",
  "statusCode": 429,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Internal server error",
  "error": "Internal Server Error",
  "statusCode": 500,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service unreachable",
  "error": "Bad Gateway",
  "statusCode": 502,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service timed out",
  "error": "Gateway Timeout",
  "statusCode": 504,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

The task queue for the whole team or for one rep. Every call, manual email and to-do a sequence produces lands here, beside the one-off tasks reps create.

Common queries

You want	Query parameters
One rep’s working queue	`state=pending&user_id=REP_ID`
The team’s call queue	`state=pending&action=call`
What is overdue	`state=pending&overdue=true`
Everything a rep must do by the end of today, overdue included	`state=pending&user_id=REP_ID&due_before=END_OF_TODAY`, with the end of today in the rep’s timezone
Highest priority first	`state=pending&sort=priority`
Everything for one prospect	`contact=CONTACT_ID`
A rep’s own to-dos	`origin=one_off&user_id=REP_ID`

Good to know

Without state, completed, skipped, expired and cancelled tasks are included. Add state=pending for work that is still open.
overdue=true filters on the due date only. Without state=pending it also returns finished tasks that were due in the past.
sort=priority with the default direction=asc puts high priority first; desc puts low priority first.
Sorts other than due rank at most 2,000 matching tasks. Narrow by state, user_id or a due window when the queue can be larger.
Each task carries its contact as an object, with the prospect’s name, company, title, phone numbers and timezone, so a row can be shown without another call.
For bucket counts (overdue, today, this week, later), call Get a task-queue summary instead of paging through rows.

Authorizations

x-api-key

string

header

required

Team-scoped API key generated in the Salesfinity dashboard under Settings → Connections → API & Webhooks. A missing or invalid key returns HTTP 403.

Query Parameters

limit

number

Results per page. Default 25. Above 100 is treated as 100.

Required range: 1 <= x <= 100

page

number

default:1

Page number, 1-based, up to 10,000.

Required range: 1 <= x <= 10000

user_id

string

A team member id for one rep's queue, or all (the default) for every assignee on the team. An id from outside the team returns no tasks.

state

enum<string>

Only tasks in this state. pending is the working queue. held tasks wait while their enrollment is paused and cannot be completed or skipped. completed, skipped, expired and cancelled are final. Omit it to get every state.

Available options:

pending,

held,

completed,

skipped,

expired,

cancelled

action

enum<string>

Only tasks of this kind. call is the call queue and manual_email the email queue. The LinkedIn actions, meeting and sms occur only on one-off tasks.

Available options:

call,

manual_email,

generic,

linkedin_connect,

linkedin_message,

linkedin_view,

linkedin_interact,

meeting,

sms

sequence

string

Only tasks from this sequence (24-character id).

origin

enum<string>

sequence for tasks created by a sequence step or a reaction, one_off for tasks reps created.

Available options:

sequence,

one_off

contact

string

Only tasks for this contact (24-character id).

priority

enum<string>

Only tasks in this priority band.

Available options:

high,

medium,

low

overdue

boolean

true returns only tasks whose due_at has passed, in any state; combine it with state=pending for the overdue queue. false is the same as leaving it out.

due_before

string<date-time>

ISO 8601. Only tasks due at or before this instant.

due_after

string<date-time>

ISO 8601. Only tasks due after this instant.

string

Case-insensitive match on the contact's first name, last name, email or company. Considers at most 500 matching contacts, so use a specific term. Ignored when contact is set.

sort

enum<string>

default:due

Order of the whole result set, applied server-side. due: due date, oldest first. priority: high, medium, low (with asc). action, prospect (contact name), company and sequence (sequence name): alphabetical. last_activity: when the Sequencer last emailed or called the contact; never-touched contacts come last in either direction. Every sort except due ranks at most 2,000 matching tasks.

Available options:

due,

priority,

action,

prospect,

company,

sequence,

last_activity

direction

enum<string>

asc (the default) or desc. Ignored by due, which is always oldest-first. With sort=priority, asc puts high priority first.

Available options:

asc,

desc

Response

A page of tasks.

A page of results.

data

object[]

required

Show child attributes

pagination

object

required

Pagination for the paged lists under /v2/sequencer. Every paged list uses this one shape; a few short lists (a sequence's steps, the team's policies, a task's events and enrollment runs) return a plain array instead.

Show child attributes

Get started

MCP server

MCP reference

MCP use cases

Dialer API

Calls and analytics API

Enrichment API

Sequencer API

List tasks

Common queries

Good to know

Authorizations

Query Parameters

Response

​Common queries

​Good to know

Authorizations

Query Parameters

Response

Common queries

Good to know