How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

American Express Global Business Travel bookings v1 API

The bookings v1 API from American Express Global Business Travel — 12 operation(s) for bookings v1.

American Express Global Business Travel bookings v1 API is one of 26 APIs that American Express Global Business Travel publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include bookings v1. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, and authentication docs.

This API exposes 13 operations across 12 paths, and defines 60 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against a single base URL, https://apis.egencia.com/openconnect/api.

13 operations 12 paths 60 schemas 4 GET9 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://apis.egencia.com/openconnect/api
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

American Express Global Business Travel bookings v1 API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth2) using the clientCredentials flow.

Paths & Operations 13

Across 12 paths, the API surfaces 13 operations — 4 GET, 9 POST. Each is listed below with its method, path, parameters, and response codes.

bookings v1 13
POST
/v1/bookings/{bookingId}/approve
Approve the complete booking based on booking ID
approveBooking 1 param → 200400401403422500501
POST
/v1/bookings/{bookingId}/deny
Deny the complete booking based on booking ID
denyBooking 1 param → 200400401403422500501
POST
/v1/bookings/{bookingId}/items/{itemId}/approve
Approve a particular booking item based on booking ID and item ID
approveBookingItem 3 params → 200400401403422500501
POST
/v1/bookings/{bookingId}/items/{itemId}/deny
Deny a particular booking item based on booking ID and item ID
denyBookingItem 3 params → 200400401403422500501
GET
/v1/bookings/{bookingId}
Retrieve trip details for a particular booking based on booking ID
getBookingProduct 1 param → 200400401403404422500
GET
/v1/bookings/{bookingId}/items/{itemId}
Retrieve booking item details for a particular item based on booking item Id
getBookingItem 2 params → 200400401403404422500
POST
/v1/bookings/{bookingId}/items/{itemId}/cancel
Cancel booking item for a particular booking
cancelBookingItem 2 params → 200400401403404422500
POST
/v1/bookings/{bookingId}/items/{itemId}/delete
Delete trip item for a particular booking ID
deleteBookingItem 2 params → 200400401403404422500
GET
/v1/bookings/{bookingId}/items/{itemId}/receipts
Fetch receipt for a booking item
getReceipt_1 2 params → 200400401403404422500
POST
/v1/bookings/{bookingId}/cancel
Cancel trip for a particular booking ID
cancelBooking 1 param → 200400401403404422500
POST
/v1/bookings/{bookingId}/delete
Delete trip items for a particular booking ID
deleteBooking 1 param → 200400401403404422500
GET
/v1/bookings
search trip details
search 6 params → 200400401403422500
POST
/v1/bookings
createBooking body → 200

Schemas 60

The contract defines 60 schemas that model the data the API accepts and returns. The most detailed are Car (38 properties), Hotel (36 properties), GlobalGround (35 properties), Flight (32 properties). Each schema is shown below with its type and property counts.

ApprovalResponse
object
Approval response after approve/deny action
3 properties
ApprovalItem
object
2 properties
ApprovalItemResponse
object
Approval response after approve/deny action on booking item
3 properties
CancelItemResponse
object
Response after cancel action on booking item
5 properties
Links
object
RulesAndRegulations
object
Details of rules and regulations
1 property
Address
object
Address
8 properties
GroundTransferType
object
2 properties 2 required
BookingProduct
object
The Egencia expense model which carries details of traveler, trips and expenses
7 properties 2 required
Fee
object
32 properties 5 required
Link
object
8 properties
Fare
object
Details about fare.
2 properties
CO2Emission
object
The details of the Carbon dioxide (CO2) emission.
5 properties
GlobalGround
object
35 properties 7 required
PolicyCompliance
object
Policy compliance details
2 properties
RateType
object
The type of inventory purchased or reserved by the traveler (Published Rate, Egencia Preferred Rate, Corporate negotiated rate, etc.).
2 properties 1 required
Train
object
31 properties 5 required
PointOfSale
object
A point of sale is defined by the intersection of a company, a management unit, and a jurisdiction.
1 property 1 required
MeetingInfo
object
Meeting details associated with an item.
6 properties
Flight
object
32 properties 5 required
SegmentStep
object
Segment related information carries location and date time info
2 properties 2 required
Company
object
Company details of the traveler
4 properties 1 required
Person
object
Details of the person
8 properties
Location
object
6 properties 1 required
CustomDataField
object
Billing data added during the booking process.
2 properties 1 required
Segment
object
Segment is part of an origin to destination.
14 properties 3 required
ViolationReason
object
Policy non-compliance reasons
3 properties
ReceiptInfo
object
Details about receipt like id, date, version etc. 'receiptinfo' appears whenever a payment receipt or an invoice has been generated for the booking.
11 properties
Traveler
object
9 properties
Price
object
Details of the price
6 properties 1 required
Provider
object
Details of the provider like code, name
2 properties 1 required
Payment
object
Details about payment.
5 properties
TravelerSegmentInfo
object
Traveler information for a segment.
3 properties
Hotel
object
36 properties 6 required
DeleteItemResponse
object
Delete response after delete action on booking item
5 properties
Car
object
38 properties 8 required
Carrier
object
Carrier details
4 properties
FlightOriginDestination
object
Details of the flight origin destination
1 property 1 required
CreditCardInfo
object
Details of credit card
3 properties
RentalVehicle
object
Details of the rental vehicle
4 properties
Partner
object
Details of the partner
1 property
CO2EmissionEquivalency
object
The CO2 emission equivalencies information.
2 properties
FirstLevelBreakdown
object
Breakdown details
5 properties 2 required
TicketInformation
object
Ticket information of traveler for a segment.
2 properties
GroundVehicle
object
4 properties
SecondLevelBreakdown
object
4 properties 2 required
DeletedItem
object
Deletion response after delete action on draft booking item
2 properties
DeleteResponse
object
Delete response after delete action
5 properties
CancelResponse
object
Cancel response after cancel action
5 properties
CancelItem
object
Cancellation response after cancel action on booking item
2 properties
BookingSearchResponse
object
2 properties
Fee_2
5 required
ItemSummary
object
Booking item summary
8 properties 1 required
GlobalGround_2
7 required
Train_2
5 required
Flight_2
5 required
BookingItem
object
26 properties 3 required
EntityModelBookingNotificationEvent
object
7 properties 1 required
Hotel_2
6 required
Car_2
8 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

amex-gbt-bookings-v1-api-openapi.yml Raw ↑

Other APIs American Express Global Business Travel publishes across the network.

American Express Global Business Travel Agent Assist Notes API
American Express Global Business Travel Approval API
American Express Global Business Travel Availability Probes Controller API
American Express Global Business Travel bookings v2 API
American Express Global Business Travel Company Details API
American Express Global Business Travel Custom Data Field Cleanup Controller API
American Express Global Business Travel Custom Data Fields (CDF) API
American Express Global Business Travel Doc Audit Clean Up Controller API
American Express Global Business Travel DutyOfCare Data API
American Express Global Business Travel Ecommerce Settings Controller API
American Express Global Business Travel Expense SPI API
American Express Global Business Travel Gdpr Controller API
Where this information came from

This is an independent, third-party profile of American Express Global Business Travel bookings v1 API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.