Skip to main content
GET
List orders

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

lang
string | null

Language preference for the response

Query Parameters

project_id
string
required

Filter by project ID. This parameter is required, pass 'All Projects' to retrieve all organization orders.

preview
boolean
default:false

If true, returns lightweight order previews instead of full order details.

page_token
string | null

Pagination token for the next page of results.

limit
integer
default:200

Maximum number of orders per page. Defaults to 200, max 1000.

Response

The list orders response

order_stats
OrderStats · object
required

Aggregated order counts broken down by state for the queried scope.

project_names
string[]
required

Project names available in the organization for filtering. When querying ALL_PROJECTS, this includes 'Personal Certificates' as the first entry followed by project names sorted alphabetically. Empty when filtering by a specific project or personal certificates.

next_page_token
string | null

Opaque token to retrieve the next page of results. Pass this as the page_token query parameter on the next request. Null when there are no more results.

orders
Order · object[] | null

Full order details. Present when preview=false.

order_previews
OrderPreview · object[] | null

Lightweight order summaries. Present when preview=true.