Skip to main content
GET
List approval requests

Authorizations

Authorization
string
header
required

Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.

Headers

Sajn-Version
enum<string>

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.

Available options:
2026-09,
2026-10

Query Parameters

limit
integer
default:25

Maximum number of items to return, from 1 to 100. Default: 25.

Required range: 1 <= x <= 100
cursor
string

The nextCursor from the previous response, to get the next page. Keep the other parameters unchanged.

Required string length: 1 - 2048
include
enum<string>[]

total adds the number of items that match the filters. Counting takes time, so ask for it only when you need it.

Available options:
total
documentId
string[]

Only requests for these documents. Comma-separated or repeated.

approverId
string[]

Only requests where one of these users is an approver. Comma-separated or repeated.

status
enum<string>[]

Only requests with one of these statuses. Comma-separated or repeated.

Available options:
DRAFT,
PENDING,
APPROVED,
REJECTED

Response

Approval requests, newest first

Approval requests, newest first

data
object[]
required
hasMore
boolean
required

True if more items follow this page.

nextCursor
string | null
required

Pass this as cursor to get the next page. Null on the last page.

total
integer

The number of items that match the filters. Present only with include=total.

Required range: -9007199254740991 <= x <= 9007199254740991