List approval requests
Lists the approval requests on documents you can read, newest first. A document has at most one request. To find the requests waiting for someone, pass approverId and status=PENDING; the result also lists requests whose turn for that approver hasn’t come yet in a later stage.
Authorizations
Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
Headers
API version for this request. Without it, the request uses the organization's default version; an organization without a default is pinned to the latest version by its first request.
2026-09, 2026-10 Query Parameters
Maximum number of items to return, from 1 to 100. Default: 25.
1 <= x <= 100The nextCursor from the previous response, to get the next page. Keep the other parameters unchanged.
1 - 2048total adds the number of items that match the filters. Counting takes time, so ask for it only when you need it.
total Only requests for these documents. Comma-separated or repeated.
Only requests where one of these users is an approver. Comma-separated or repeated.
Only requests with one of these statuses. Comma-separated or repeated.
DRAFT, PENDING, APPROVED, REJECTED Response
Approval requests, newest first
Approval requests, newest first
True if more items follow this page.
Pass this as cursor to get the next page. Null on the last page.
The number of items that match the filters. Present only with include=total.
-9007199254740991 <= x <= 9007199254740991
