Get one booking#

GET/v1/bookings/{bookingId}

Convenience for a single booking. Prefer the bulk form with bookingIds. A booking that exists but belongs to another agent group comes back 404, identically to one that doesn't exist at all — this response can never be used to confirm that a booking id exists outside the caller's own group.

Request

cURL

curl -X GET 'https://partner-api.elivaas.com/v1/bookings/{bookingId}' \
  -u "$ELIVAAS_API_KEY:" \
  -H 'Content-Type: application/json'

Node.js

const res = await fetch('https://partner-api.elivaas.com/v1/bookings/{bookingId}', {
  method: 'GET',
  headers: {
    Authorization: 'Basic ' + Buffer.from(process.env.ELIVAAS_API_KEY + ':').toString('base64'),
    'Content-Type': 'application/json',
  },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

Python

import os, requests
res = requests.get(
    "https://partner-api.elivaas.com/v1/bookings/{bookingId}",
    auth=(os.environ["ELIVAAS_API_KEY"], ""),
    timeout=30,
)
res.raise_for_status()
data = res.json()

Response 200

{
  "bookingId": "bkg_20Etl54TyDHROM",
  "code": "EV-100234",
  "status": "CONFIRMED",
  "checkIn": "2026-08-10",
  "checkOut": "2026-08-13",
  "totalAmount": 29553,
  "outstandingAmount": 0,
  "paidAmount": 29553,
  "createdAt": "2026-02-15T22:00:57.719717Z",
  "updatedAt": "2026-05-21T11:09:03.024811Z"
}

Path parameters#

bookingIdstringrequired: No description in the spec.

Responses#

Status	Meaning
`200`	OK
`400`	Validation failure. The message names the offending parameter. Limits are rejected, never silently clamped: an over-length id list, a page size above 100 or a date window longer than 365 days all land here rather than coming back quietly truncated.
`401`	Missing, malformed, revoked or unknown API key, or an agent group whose distribution access is disabled. Pass the key as the HTTP Basic username with an empty password.
`404`	No such resource on your channel. A resource that exists but belongs to another tenant is reported identically — the two are never distinguished, so this response can't be used to enumerate ids.
`429`	Rate limit exhausted for this credential. Wait `Retry-After` seconds before retrying; the budget is per credential, not per IP.

See Errors for the error body shape and which statuses are worth retrying.