HTTP APIReference
List orders
The user's hotel orders, newest first, including those made on the Fortrip website.
The full rules agents follow for this call are on its MCP tool's page, list_orders.
GET
bearerAuthheader
AuthorizationBearer <token>A Fortrip OAuth access token from the device authorization flow (RFC 8628). GET /v1/auth/config returns the flow's endpoints.
cursor?stringnextCursor from the previous page of orders.
Length
1 <= lengthlimit?integerOrders per page, 1 to 50. Default 20.
Range
1 <= value <= 50locale?stringLanguage for names and text in the response: en or zh.
Value in
"en""zh"List orders
application/json- response
data*array<>nextCursor*|Pass it back as cursor for the next page; null on the last page.
[key: string]?unknowncurl -X GET 'https://api.fortrip.ai/v1/orders'Example Response
{ "data": [ { "orderId": "string", "reference": "string", "status": "awaiting_payment", "createdAt": "string", "updatedAt": "string", "items": [ { "type": "hotel", "hotel": { "hotelId": "string", "name": "string", "names": { "en": "string", "zh": "string", "property1": null, "property2": null }, "checkIn": "string", "checkOut": "string", "timeZone": "string", "rooms": [ { "adults": -9007199254740991, "childrenAges": [ -9007199254740991 ], "property1": null, "property2": null } ], "room": { "name": { "text": "string", "locale": "en", "property1": null, "property2": null }, "beds": { "text": "string", "locale": "en", "property1": null, "property2": null }, "property1": null, "property2": null }, "meals": { "known": true, "included": [ "breakfast" ], "unspecifiedMainMeals": -9007199254740991, "allInclusive": true, "guestsCoveredPerRoom": -9007199254740991, "label": { "text": "string", "locale": "en", "property1": null, "property2": null }, "property1": null, "property2": null }, "cancellation": { "status": "free", "asOf": "string", "freeCancellationEndsAt": "string", "penalties": [ { "startsAt": "string", "amount": { "amount": "string", "currency": "string", "property1": null, "property2": null }, "property1": null, "property2": null } ], "timeZone": "string", "property1": null, "property2": null }, "payAtProperty": { "disclosure": "complete", "items": [ { "label": { "text": "string", "locale": "en", "property1": null, "property2": null }, "amount": { "amount": "string", "currency": "string", "property1": null, "property2": null }, "mandatory": true, "basis": "per_stay", "collectedAt": "property", "property1": null, "property2": null } ], "property1": null, "property2": null }, "confirmationNumber": "string", "property1": null, "property2": null }, "property1": null, "property2": null } ], "price": { "total": { "amount": "string", "currency": "string", "property1": null, "property2": null }, "property1": null, "property2": null }, "payment": { "status": "unpaid", "url": "string", "requiresSignIn": true, "expiresAt": "string", "chargeCurrency": "string", "localCurrencyAtCheckout": true, "localCharge": { "amount": "string", "currency": "string", "property1": null, "property2": null }, "handlers": [ { "id": "string", "type": "string", "version": "string", "spec": "string", "schema": "string", "available_instruments": [ { "type": "string", "config": { "property1": null, "property2": null }, "property1": null, "property2": null } ], "config": { "environment": "livemode", "business_profile": "string", "property1": null, "property2": null }, "property1": null, "property2": null } ], "credentialLimits": { "maxAmount": -9007199254740991, "currency": "string", "expiresAt": "string", "property1": null, "property2": null }, "wallets": { "open": true, "current": "wechat_pay", "wechatPay": { "qrData": "string", "qrImageUrl": "string", "url": "string", "property1": null, "property2": null }, "alipay": { "url": "string", "property1": null, "property2": null }, "property1": null, "property2": null }, "property1": null, "property2": null }, "cancel": { "available": true, "reason": "cancellable", "penalty": { "amount": "string", "currency": "string", "property1": null, "property2": null }, "refund": { "amount": "string", "currency": "string", "property1": null, "property2": null }, "property1": null, "property2": null }, "manageUrl": "string", "property1": null, "property2": null } ], "nextCursor": "string", "property1": null, "property2": null}