List Bookings

Retrieve a paginated list of bookings in your workspace.

Method

GET /v1/bookings

Query Parameters

limit · integer

Items per page (default 20, max 100)

offset · integer

Number of items to skip (default 0)

status · string

Filter by status (pending, confirmed, cancelled, completed)

q · string

Search text (code, customer name/email)

locale · string

Response locale (e.g. en, ro)

sort · string

Sort field (e.g. createdAt, updatedAt)

dir · string

Sort direction: asc or desc

Headers

Authorization · string · required

Bearer token (e.g. Authorization: Bearer YOUR_API_KEY)

cURL

curl "https://api.voyantcloud.com/v1/bookings?limit=20&offset=0&q=PAR-2025" \
  -H "Authorization: Bearer YOUR_API_KEY"

200 OK

{
  "data": [
    {
      "id": "bkg_456def",
      "code": "BKG-2025-0001",
      "status": "confirmed"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 20,
    "offset": 0,
    "hasMore": false
  }
}