Skip to main content
GET
List objectives
Returns objectives newest first by native creation time. limit defaults to 50, at most 100 (a larger value is 400 too_big). Optional filters are ownerKind, ownerRefId, and status; ownerRefId requires a non-worker ownerKind. Pass meta.nextCursor unchanged while meta.hasMore is true.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Query Parameters

ownerKind
enum<string>
Available options:
company,
orgUnit,
worker
ownerRefId
string
status
enum<string>
Available options:
DRAFT,
ACTIVE,
COMPLETE,
CANCELLED
cursor
string
limit
integer
default:50
Required range: 1 <= x <= 100

Response

Objective page

data
object[]
required
meta
object
required

A list page's continuation. While hasMore is true, nextCursor is a string: pass it as cursor for the next page. hasMore: false ends the list; with truncated: true, more exist past what this list reads, and no cursor reaches them.