Skip to main content

​
Method

GET /v1/bookings/:id

​
Path Parameters

​
id
string
required
Booking ID (TypeID with book prefix)

​
Query Parameters

​
locale
string
Response locale (e.g. en, ro)

​
Headers

​
Authorization
string
required
Bearer token (e.g. Authorization: Bearer YOUR_API_KEY)
curl "https://api.voyantcloud.com/v1/bookings/book_01h9xm4n5p6q7r8s9t0v1w2x3y?locale=en" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

​
id
string
required
Booking ID
​
code
string
required
Human-readable booking reference
​
status
string
required
Booking status: pending, confirmed, cancelled, completed
​
product
object
Product information
​
departure
object
Departure information
​
customer
object
Customer details
​
passengers
array
List of passengers
​
pricing
object
Pricing breakdown
​
payment_status
string
Payment status: unpaid, partial, paid, refunded
​
created_at
timestamp
Creation timestamp
​
updated_at
timestamp
Last update timestamp
{
  "id": "book_01h9xm4n5p6q7r8s9t0v1w2x3y",
  "code": "BKG-2025-0001",
  "status": "confirmed",
  "product": {
    "id": "prod_01h8z3y4x2w1v0u9t8s7r6q5p4",
    "title": "Paris City Tour",
    "type": "tour"
  },
  "departure": {
    "id": "dept_01h9xm2n3p4q5r6s7t8v9w0x1y",
    "start_at": "2025-06-15T09:00:00Z",
    "end_at": "2025-06-15T18:00:00Z"
  },
  "customer": {
    "id": "ppl_01h9xm5n6p7q8r9s0t1v2w3x4y",
    "first_name": "John",
    "last_name": "Doe",
    "email": "[email protected]",
    "phone": "+1234567890"
  },
  "passengers": [
    { "id": "bkpx_01h9xm6n7p8q9r0s1t2v3w4x5y", "first_name": "John", "last_name": "Doe", "type": "adult", "date_of_birth": "1985-06-15" },
    { "id": "bkpx_01h9xm7n8p9q0r1s2t3v4w5x6y", "first_name": "Jane", "last_name": "Doe", "type": "adult", "date_of_birth": "1987-03-22" }
  ],
  "pricing": {
    "subtotal": 1500.00,
    "tax": 285.00,
    "total": 1785.00,
    "currency": "EUR"
  },
  "payment_status": "paid",
  "created_at": "2025-01-15T10:30:00Z",
  "updated_at": "2025-01-15T11:00:00Z"
}