Skip to main content
GET
Get document approval status
You’re viewing API version 2026-09, which is deprecated and stops working on October 1, 2027. To see the current version, select 2026-10 in the menu at the top of the sidebar. To move your integration, see Upgrading to 2026-10.

Authorizations

Authorization
string
header
required

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

Headers

authorization
string
required

Bearer token for API authentication

Path Parameters

id
string
required

Response

Document approval status

Document approval status

id
string
required

Approval ID

documentId
string
required

Document ID

status
enum<string>
required

Overall approval status, derived from the chain: REJECTED if any step was rejected, PENDING if any step is still pending, otherwise APPROVED

Available options:
PENDING,
APPROVED,
REJECTED
autoSend
boolean
required

Whether the document is sent automatically once the chain fully approves

approvers
object[]
required

The ordered approval chain

requestedBy
object
required

The user who submitted for approval

customMessage
string | null
required

Custom message for signing invitation

createdAt
any
required

When the approval was requested