Skip to main content
GET
Preview the cancellation refund

Authorizations

Authorization
string
header
default:sk_test_DEMO0000_replace_with_your_sandbox_key
required

API key authentication. Issued by the Safariat admin or via the partner portal. The secret is shown only once at generation.

Production sk_live_* keys must additionally sign every write request (POST/PUT/DELETE) with the X-Timestamp and X-Signature headers. Sandbox sk_test_* keys are exempt from request signing: X-Signature and X-Timestamp are not required for writes in the sandbox (so the developer-portal "Try it" playground works end to end). The Idempotency-Key header remains required on writes in both environments.

Path Parameters

booking_number
string
required

Safariat booking number (format MV-XXXXXX). In the sandbox, create a booking first (POST /bookings) and use the returned number here.

Pattern: ^MV-[A-Z0-9]{6}$

Response

Cancellation quote computed (no change made)

booking_number
string
required
evaluated_at
string<date-time>
required

Server time at which the quote was computed.

refund
object
required
tier_applied
object | null

Omitted when no tier matched (full or zero refund applies).

free_cancellation_deadline
string<date-time> | null

Last instant a cancellation still yields the maximum refund tier. null when there is no free-cancellation tier.