trama.

List reservations

Returns the organization's reservations, most recently created first.

GET
/v1/reservations

Returns the organization's reservations, most recently created first.

Authorization

AuthorizationBearer <token>

The organization API key, sent as Authorization: Bearer <key>.

In: header

Query Parameters

limit?integer

How many items to return. Maximum 100.

Range1 <= value <= 100
Default25
offset?|

How many items to skip from the beginning.

Range0 <= value
Default0
poolId?string
status?string

Value in

  • "hold"
  • "confirmed"
  • "cancelled"
  • "expired"
  • "no_show"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/reservations"
{  "data": [    {      "allocationId": "string",      "cancelledAt": "2019-08-24T14:15:22Z",      "channel": "string",      "confirmedAt": "2019-08-24T14:15:22Z",      "createdAt": "2019-08-24T14:15:22Z",      "customerId": "string",      "externalId": "string",      "guestName": "string",      "holdExpiresAt": "2019-08-24T14:15:22Z",      "id": "string",      "notes": "string",      "occupancyNights": 0,      "occupancyStart": "string",      "opportunityId": "string",      "pax": 0,      "poolId": "string",      "quantity": 0,      "slotKey": "string",      "source": "platform",      "status": "hold",      "updatedAt": "2019-08-24T14:15:22Z"    }  ],  "pagination": {    "limit": 0,    "offset": 0,    "total": 0  }}

Update a variant's declared availability PATCH

Declares how many spots are left on one variant, and whether it is on sale. Idempotent: send only what changed, repeat it as often as you like. The product can be addressed by Trama's id or by your own `externalReferenceCode`. 🔴 This is a DECLARATION, not a booking ledger. Trama never decrements it when a conversation closes, there are no holds and no overbooking checks — the number is whatever you last wrote. `inventoryUpdatedAt` is stamped by the server on every write; a `sold_out` or `closed` variant stops being quoted by the AI agent, and a remaining count stops being repeated once it goes stale.

Record a reservation POST

The event that X was purchased. Occupies the book. Idempotent per `externalId`. Defaults to `confirmed` — an external system reporting a sale is not placing a hold.