GET
/
bookings
Pull booking data
curl --request GET \
  --url https://integrations-dev.cteleport.com/bookings \
  --header 'X-Api-Key: <api-key>'
[
  {
    "id": "BK-2024-5001",
    "locator": "ABC123",
    "state": "confirmed",
    "price": {
      "total": 1250,
      "ccy": "USD"
    },
    "actions": [
      {
        "action": "confirmed",
        "timestamp": 1692100800,
        "user": "agent@cteleport.com"
      }
    ],
    "segments": [
      {
        "carrier": "SQ",
        "flight_number": "SQ321",
        "origin": "MNL",
        "destination": "SIN",
        "departure": "2024-08-15T08:00:00Z",
        "arrival": "2024-08-15T12:00:00Z",
        "cabin_class": "economy"
      }
    ],
    "passengers": [
      {
        "last_name": "Smith",
        "first_name": "John",
        "id": "EMP-001"
      }
    ],
    "terms": {
      "fare_type": "flex",
      "splitting": true,
      "cancellations": "Free cancellation up to 24h before departure",
      "changes": "Free changes up to 24h before departure"
    },
    "baggage": {
      "MNL-SIN": "23kg"
    },
    "metadata": {
      "crew_change_member": "EMP-001",
      "crew_change_airport": "SIN",
      "crew_change_date": "2024-08-20"
    }
  }
]

Authorizations

​
X-Api-Key
string
header
required

API key provided by C Teleport for integration access.

Query Parameters

​
days
integer

Limit results to bookings from the last N days (1–30). When omitted, returns the full delta since the last pull.

Required range: 1 <= x <= 30

Response

Array of bookings with accumulated actions.

​
id
string
default:BK-2024-5001

C Teleport booking identifier.

Example:

"BK-2024-5001"

​
locator
string
default:ABC123

Airline PNR/record locator.

Example:

"ABC123"

​
state
enum<string>
default:confirmed

Current state of the booking.

Available options:
confirmed,
issued,
refund_pending,
cancelled,
approval_required,
declined,
change_pending
Example:

"confirmed"

​
price
object

Price information for the booking.

​
actions
object[]

Chronological list of actions performed on this booking.

​
segments
object[]

Flight segments in the booking.

​
passengers
object[]

Passengers on this booking.

​
terms
object

Fare terms and conditions for the booking.

​
baggage
object

Baggage allowance information keyed by route string (e.g., "MNL-SIN"). Each value describes the baggage allowance for that route segment.

Example:
{ "MNL-SIN": "23kg" }
​
metadata
object

Additional metadata associated with the booking. Contains travel change information and may include additional customer-specific fields.