Skip to main content
POST
Create 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

Body

application/json
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_-]+$

Response

The original pre-authorization for an idempotent replay

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
Last modified on July 30, 2026