Skip to main content
GET
List tasks

Authorizations

Authorization
string
header
required

Supabase JWT — Authorization: Bearer <token>.

Query Parameters

merchant_id
string<uuid>

Optional merchant to scope to. Admins and sub-merchant operators only; other callers always use their token's merchant.

Example:

"28106cba-1c27-4e53-b149-32113e5e8e31"

scope
enum<string>
default:mine

mine (assigned to you, default), created (created by you) or all (every task of the company; owners only). Ignored with candidate_id, position_id or assignee_profile_id.

Available options:
mine,
created,
all
candidate_id
string<uuid>

Only tasks about this candidate (profile_interview.id), including those about one of their applications.

position_id
string<uuid>

Only tasks about this position (position_def_set.id) or interview (interview_def_set.id) itself.

assignee_profile_id
string<uuid>

Only tasks assigned to this user (profile.id). Without candidate_id and position_id this lists a team member's tasks: owners only.

status
enum<string>
default:open

open (default), done, cancelled or all.

Available options:
open,
done,
cancelled,
all
due
enum<string>

Only open tasks overdue, due today (company time zone), upcoming, or without a due date (none).

Available options:
overdue,
today,
upcoming,
none
limit
integer
default:50

Tasks per page (1 to 500, default 50).

Required range: 1 <= x <= 500
Example:

50

offset
integer | null
default:0

Number of records to skip from the start of the result set.

Required range: x >= 0
Example:

0

Response

One page of tasks, your task counts.

data
object[]
required

Tasks of this page: open ones overdue first, then due today, upcoming, without a due date; then done and cancelled, newest first.

pagination
object
required
counts
object
required

Your own open tasks (as the To do menu shows them), whatever the filters.

truncated
boolean
required

true when more than 500 tasks matched the database query: only the first 500 can be paged and counted. Narrow the filters.