/v1/bookings/{reservationId} (GET)

GET

/v1/bookings/{reservationId}

const url = 'http://localhost:8787/v1/bookings/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url http://localhost:8787/v1/bookings/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Authorization: Bearer <token>'

Authorizations

ApiKeyAuth
SessionCookie

Parameters

Path Parameters

reservationId

required

string format: uuid

Responses

200

The booking, including PII (guestEmail) — sk_ only.

application/json

object

createdAt

required

string

currency

required

string

>= 3 characters <= 3 characters

endsAt

required

string

guestEmail

required

string | null

holdExpiresAt

required

string | null

required

string format: uuid

occupancyAdults

required

integer | null

occupancyChildren

required

integer

quantity

required

integer

ratePlanId

required

string | null format: uuid

resourceId

required

string format: uuid

roomTypeId

required

string | null format: uuid

source

required

string

startsAt

required

string

state

required

string

Allowed values: pending held confirmed cancelled checked_in checked_out no_show expired

totalMinorUnits

required

string

/^\d+$/

updatedAt

required

string

Example

{
  "state": "pending"
}

404

No such booking for this tenant (also returned for a pk_ key — never reachable).

application/problem+json

object

code

required

string

Allowed values: booking_not_found illegal_transition invalid_cursor

detail

required

string

status

required

number

title

required

string

type

required

string

Example

{
  "code": "booking_not_found"
}