Skip to main content
GET
Get a task-queue summary
Bucket counts of a rep’s or the team’s open tasks, for badges and inbox headers, without paging through rows.

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 pending tasks are counted. Held tasks are not.
  • Each bucket includes its end: a task due exactly at today_ends counts as today.
  • pending equals the sum of the other buckets when you send both edges, today_ends is still in the future, and week_ends is later than today_ends.
  • To fetch the rows behind a bucket, call List tasks with state=pending and the same window, for example due_after=NOW&due_before=TODAY_ENDS for today.

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

user_id
string

A team member id to count one rep's queue, or all (the default) for the whole team.

today_ends
string<date-time>

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.

week_ends
string<date-time>

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.

pending
integer
required

Every pending task in scope.

overdue
integer
required

Pending tasks due at or before now.

due_today
integer

Due after now and by today_ends. Only when today_ends is sent.

this_week
integer

Due after today_ends and by week_ends. Only when both are sent.

later
integer

Due after week_ends. Only when week_ends is sent.