Skip to main content
POST
Decide a pre-authorization

Authorizations

Authorization
string
header
required

A sandbox or production secret key.

Headers

Idempotency-Key
string
required

A caller-owned key for safely retrying one write.

Required string length: 8 - 255

Path Parameters

preauthorization_id
string
required

A public pre-authorization identifier.

Maximum string length: 100
Pattern: ^preauth_[A-Za-z0-9_-]+$

Body

application/json
outcome
string
required
Allowed value: "approved"
approved_amount
integer
required
Required range: 1 <= x <= 9007199254740991
valid_until
string<date-time>
required
reason_codes
string[]
required
Required array length: 1 - 32 elements
Pattern: ^[a-z0-9_]{2,80}$
policy_reference
string
required
Required string length: 3 - 200
Pattern: ^[A-Za-z][A-Za-z0-9:_-]+$
policy_version
string
required
Required string length: 1 - 100
evidence_references
string[]
required
Required array length: 1 - 29 elements
Required string length: 3 - 300
Pattern: ^[A-Za-z][A-Za-z0-9:_-]+$

Response

The decided pre-authorization

id
string
required
Maximum string length: 100
Pattern: ^preauth_[A-Za-z0-9_-]+$
object
string
required
Allowed value: "preauthorization"
eligibility_check_id
string
required
Maximum string length: 100
Pattern: ^elig_[A-Za-z0-9_-]+$
booking_id
string
required
Maximum string length: 100
Pattern: ^bkg_[A-Za-z0-9_-]+$
status
enum<string>
required
Available options:
pending,
approved,
denied,
expired,
cancelled
reason_codes
string[]
required
amount
object
required
valid_until
string<date-time> | null
required
created_at
string<date-time>
required
decision
object | null
required
Last modified on August 6, 2026