Skip to main content
GET
List projects
Lists visible projects with cursor pagination. limit defaults to 50, at most 100 (a larger value is 400 too_big). Without customerId, projects are newest first and status filters after paging. With customerId, the customer/status index determines order. A page may be short or empty 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

limit
integer
default:50
Required range: 1 <= x <= 100
cursor
string
Minimum string length: 1
status
enum<string>
Available options:
PLANNING,
ACTIVE,
ON_HOLD,
COMPLETE,
ARCHIVED
customerId
string
Minimum string length: 1

Response

Success

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.