Get Booking

Retrieve booking details by ID.

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

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

200 OK

{
  "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": "[e-mail]",
    "phone": "[phone]"
  },
  "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"
}