Get a task-queue summary
Counts the team’s pending tasks by due bucket, without fetching any rows.
Always returns pending (every pending task) and overdue (due at or before now). Send today_ends to also get due_today (due after now and by today_ends), week_ends to get later (due after week_ends), and both to get this_week (due after today_ends and by week_ends).
Compute both edges in the rep’s own timezone: “today” is a local-calendar question, and the API does not know the rep’s timezone. user_id (default all) narrows the counts to one assignee with the same rule as GET /v2/sequencer/tasks, so the counts match the rows it returns for state=pending. Counts against the Sequencer reads rate limit.
Example
For a rep in Chicago (UTC-5) on Thursday 1 October 2026, with the week ending on Sunday:GET /v2/sequencer/tasks/summary?user_id=REP_ID&today_ends=2026-10-01T23:59:59-05:00&week_ends=2026-10-04T23:59:59-05:00
Good to know
- Only
pendingtasks are counted. Held tasks are not. - Each bucket includes its end: a task due exactly at
today_endscounts as today. pendingequals the sum of the other buckets when you send both edges,today_endsis still in the future, andweek_endsis later thantoday_ends.- To fetch the rows behind a bucket, call List tasks with
state=pendingand the same window, for exampledue_after=NOW&due_before=TODAY_ENDSfor today.
Authorizations
Team-scoped API key generated in the Salesfinity dashboard under Settings → Connections → API & Webhooks. A missing or invalid key returns HTTP 403.
Query Parameters
A team member id to count one rep's queue, or all (the default) for the whole team.
ISO 8601. End of the rep's local today, for example 2026-10-03T23:59:59-05:00. Adds due_today, and with week_ends adds this_week.
ISO 8601. End of the rep's local week. Adds later, and with today_ends adds this_week.
Response
Counts of pending tasks.
Counts of pending tasks by due bucket. The optional keys appear only when their edges are sent.
Every pending task in scope.
Pending tasks due at or before now.
Due after now and by today_ends. Only when today_ends is sent.
Due after today_ends and by week_ends. Only when both are sent.
Due after week_ends. Only when week_ends is sent.