openapi: 3.2.0
info:
description: "Introduction to the Document
\nThis document provides a reference to the Expense SPI. This document includes a series of notes and instructions that outline the Expense SPI.
\nAudience
\nThis document is aimed for the Egencia Expense SPI customers, partners and software developers who would like to consume the Expense SPI.
\nOverview
\nThe user must implement a web service in compliance with this specification and service contract. Egencia will call this web service for each transaction (each booking, fee when applicable). Each transaction will be sent in JSON format to the consumer through a POST message to the provided endpoint according to the following payload.
\n\nExpense SPI
\n\nEgencia provides an \"Expense capability\" that will push the update in near real-time to the connected client system. Expense SPI will notify the partner when a booking is created or updated in Egencia.
\n\n - When a booking is created or updated in Egencia the Expense SPI will push a message to the connected Partner system (web service).
\n - The web service to consume this data has to be built by the client consumer. This web service allows Egencia to notify the partner when a booking is created or updated in the Egencia tools by sending the booking details.
\n - The web service returns a success message if the message has been taken into account or not.
\n
\n\nAuthentication
\n\nAPI Key Authentication scheme
\n\nThe Expense SPI uses API keys to authenticate requests. An application programming interface key (API key) is a unique identifier used to authenticate a user, developer, or calling program to an API.
\nThe partner provides API Key. This API Key is securely stored in our Vault and will be used for authenticating with the partner every time we make a call.
\nYou can authenticate the requests by validating the API Key when you receive an incoming request call from Expense SPI. We will pass the API key with every request and you (The Partner) will validate the API Key, if the API key is valid then you can accept and process request. If the API Key provided is invalid, then the authentication fails and we will receive an Authentication Failure error.
\n\nURI Scheme
\n\n
\n \n \n | Request Method | \n POST | \n
\n \n | Host | \n any.client-of-expense.com | \n
\n \n | Base path | \n /some.base.path | \n
\n \n | Schemes | \n HTTP, HTTPS | \n
\n \n
\n
Security
\nBelow are the supported authentication mechanisms by the SPI
\n\n
\n \n \n | Type | \n Name | \n In | \n
\n \n \n \n | Api Key | \n x-api-key | \n Header | \n
\n \n
\n
Versioning
\nEgencia will notify the Client about the availability of new major versions and provide the timeframe for the upgrades. Major version is a new version of the software with a significant change(s). Minor version is a new version of the software with possible backward compatibility and with a minor degree of change. The changes can be structural, and can contain enhancements, major bug fixes, or change of behaviour, endpoint changes, new fields added, or fields removed. The version change log will list all the changes included in the corresponding version from the previous one.
\nVersion Change Log
\nYou can also see a full API version change log under this heading.
\n\n
\n \n \n | API | \n Current Version | \n What has changed? | \n
\n \n \n \n | Expense SPI | \n Version 1 | \n First stable version. | \n
\n \n
\n
Expense SPI Details
"
title: Expense SPI API
version: v1.0
servers:
- url: https://apis.egencia.com/openconnect-expensestream-service
description: Generated server url
tags:
- description: Push Expense and Subscription Operation. This is only an example. The path and the host are specific for each implementor. However, the model is fixed and versioned.
name: Expense SPI
paths:
/some.base.path/some.path:
post:
description: 'The SPI handles all the standard HTTP return codes. The ''Responses'' below shows the codes that will trigger an automatic retry mechanism on our side in order to enhance the success of the delivery. For any other error or when the maximum retries has been reached, it will need a manual intervention and we might contact your technical service if the issue comes from your server.
'
operationId: pushExpense
parameters:
- description: Time Stamp in format ISO DATE TIME
example: '2011-12-03T10:15:30'
in: header
name: message_timestamp
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Expense'
required: true
responses:
'200':
content:
application/json:
examples:
Expense message for a Car booking:
description: Expense message for a Car booking
value:
uuid: 109279f6-c8d8-4a7b-9630-b32e3ec690e2
expense_id: CR-5062d617d50fce1db44d72225419bff237322e79
expense_version: 1
expense_type: CAR
booking_status: BOOKED
rate_type:
code: EGENCIA
name: E1D09
point_of_sale:
country_code: GB
policy_compliance:
is_compliant: true
approval_triggered: false
egencia_trip_id: 0600-2504-064
egencia_trip_link: https://www.egencia.eu/trip-webapp/0600-2504-064?auth_gpid=41543
company:
id: 41543
name: Test Auto Airfusion FR
organization_parent_id: 1234567890
travelers:
- id: 5328422
first_name: Test
is_guest: false
last_name: User
email: test.user@example.com
preferred_language: fr
booker:
email: test.user@example.com
first_name: Test
last_name: User
id: 5328421
is_agent: false
custom_data_fields:
- label: Legal Entity
value: Wise 42
- label: Mission number
value: 123gdf
receipt_provision_available: false
price:
amount: 46.27
currency: EUR
cost_to_customer: 46.27
breakdowns:
- amount: 37.33
currency: EUR
type: BASE
- amount: 8.94
currency: EUR
type: FEES
vehicle:
acriss_code: MBMR
mileage_limit: UNLIMITED
name: Group A - Fiat 500
category: M
vendor:
code: ZI
name: Avis
drop_off:
date_time: '2019-11-14T09:00:00.000Z'
location:
address:
city_name: MANCHESTER
country_code: GBR
country_name: Great Britain
postal_code: '2345'
street_name: manchester street1 manchester street2
code: MANCHESTER
name: MANCHESTER airport avis agency
type: ADDRESS
pick_up:
date_time: '2019-11-13T09:00:00.000Z'
location:
address:
city_name: LONDON
country_code: GBR
country_name: Great Britain
postal_code: TW6 2QA
street_name: 'LONDON HEATHROW AIRPORT
LONDON HEATHROW AIRPORT T3-4'
code: LONDON
name: London airport avis agency
type: ADDRESS
is_pick_up_delivery: true
is_drop_off_collection: false
number_of_drivers: 1
amenities:
- ACD
rules_and_regulations:
details:
- 'Guarantee Information
RATE GUARANTEED 108 DAYS FROM BOOKING '
- Extra charge - EUR47.99 per day.
booking_reference: JQPIHQ
gds_reference: 22736607DE5
vendor_reference: 22736607DE5
payment_method: CREDIT_CARD
credit_card:
first6_digits: '411111'
last4_digits: '1111'
mission_number: 123gdf
booking_date_time: '2021-09-30T12:35:20.000Z'
_links:
self:
href: https://apis.egencia.eu/openconnect/api/v1/bookings/0600-2504-064/items/6450a5b869d5bd432ab9cca7
trip:
href: https://www.egencia.eu/trip-webapp/0600-2504-064?auth_gpid=41543
Expense message for a Car cancellation (Agent Assisted, Agency):
description: Expense message for a Car cancellation (Agent Assisted, Agency)
value:
uuid: d57433e2-a458-4809-86a2-d6bb188f39a1
expense_id: CR-8b2b195f5a0aa462a7da2a4e6660656f1ee4df61
expense_version: 2
point_of_sale:
country_code: FR
company:
id: 64143
name: caspianTestCompany_FR
organization_parent_id: 6556965
travelers:
- id: 7819084
first_name: Test
last_name: User
email: test.user@example.com
preferred_language: fr
custom_data_fields:
- label: Main cost centre
value: CC1
- label: Employee ID
value: '2222'
booker:
id: 7805999
first_name: Test
last_name: Agent
email: test.agent@example.com
is_agent: true
partner:
name: xxx
price:
currency: EUR
amount: 76.8
cost_to_customer: 0.0
breakdowns:
- type: Base price
currency: EUR
amount: 48.0
- type: Taxes and fees
currency: EUR
amount: 28.8
refunds:
- type: Complete Refund
currency: EUR
amount: 76.8
egencia_item_id: 68e67a5a772f0921253cd6f4
egencia_trip_id: 2000-3177-352
egencia_trip_link: https://www.egencia.eu/trip-webapp/2000-3177-352?auth_gpid=64143
approval_triggered: false
payment_method: PAY_AT_COUNTER
expense_type: CAR
gds_reference: ZJNAOQ (SGP)
vendor_reference: 2003153466COUNT
booking_reference: ZJNAOQ
custom_data_fields:
- label: Main cost centre
value: CC1
- label: Employee ID
value: '2222'
rate_type:
name: ED2FR
code: EGENCIA
rules_and_regulations:
details:
- GENERAL SURCHARGE
- ONE WAY CHARGE
- TAX
- COLLISION DAMAGE WAIVER - EUR18.0 per day.
- SUPER PERSONAL ACCIDENT INSURANCE - EUR10.03 per day.
- PERSONAL ACCIDENT INSURANCE - EUR6.02 per day.
- EP - EUR15.0 per day.
- S/DW1 - EUR10.03 per day.
policy_compliance:
is_compliant: true
booking_date_time: '2025-10-08T00:00:00.000Z'
cancellation_date_time: '2025-10-20T14:47:55.917Z'
booking_status: CANCELLED
vendor:
code: ET
name: Enterprise
vehicle:
name: CITROEN C3 OR SIMILAR
acriss_code: EDMR
category: E
mileage_limit: Unlimited
pick_up:
location:
type: ADDRESS
code: PAR
address:
street_name: TERMINAL 1 ET 2 ROISSY APT BP 332 CEDE
country_code: FRA
city_name: ROISSY
state_province_name: J
postal_code: '95716'
date_time: '2025-10-31T09:00:00.000+01:00'
drop_off:
location:
type: ADDRESS
code: PAR
address:
street_name: AEROGARE ORLY OUEST BP 447
country_code: FRA
city_name: ORLY
state_province_name: J
postal_code: '94947'
date_time: '2025-11-01T13:30:00.000+01:00'
number_of_drivers: 1
_links:
self:
href: https://apis.egencia.eu/openconnect/api/v1/bookings/2000-3177-352/items/68e67a5a772f0921253cd6f4
trip:
href: https://www.egencia.eu/trip-webapp/2000-3177-352?auth_gpid=64143
Expense message for a Flight booking (Agent Assisted):
description: Expense message for a Flight booking (Agent Assisted)
value:
uuid: b49f8299-e779-4897-8914-a3f7b3566a45
expense_id: FT-4f1e0a11d29287683124630f9f8aa996b2ff1e5c
expense_version: 3
point_of_sale:
country_code: US
company:
id: 64139
name: CaspianUSCompany
organization_parent_id: 6556964
travelers:
- id: 7854234
first_name: Test
last_name: User
email: test.user@example.com
preferred_language: en
custom_data_fields: []
is_guest: false
booker:
id: 7798007
first_name: Test
last_name: Agent
email: test.agent@example.com
is_agent: true
partner:
name: xxx
price:
currency: USD
amount: 264.19
cost_to_customer: 264.19
breakdowns:
- type: BASE
currency: USD
amount: 264.19
- type: TAXES
currency: USD
amount: 264.19
egencia_item_id: 6a3170346cd5e06ad2673e0b
egencia_trip_id: 0000-3903-531
egencia_trip_link: https://www.egencia.com/trip-webapp/0000-3903-531?auth_gpid=64139
approval_triggered: false
payment_method: COMPANY_FORM_OF_PAYMENT
expense_type: FLIGHT
gds_reference: B7MCNC
vendor_reference: B7MCNC
booking_reference: '21894966357'
custom_data_fields: []
policy_compliance:
is_compliant: true
booking_date_time: '2026-06-16T08:48:04.000Z'
receipt_provision_available: true
receipt_info:
id: 6a3170c7f91c659fa8355b41
status: AVAILABLE
version: 1
receipt_number: '21894966357'
receipt_date: '2026-06-16'
total_amount:
currency: USD
amount: 299.4
payments:
- date: '2026-06-16'
date_time: '2026-06-16T15:48:32.422490956'
net_amount:
currency: USD
amount: 299.4
credit_card_info:
last4_digits: '4448'
first6_digits: '444444'
card_type: VISA
breakdowns:
- type: BaseFare
currency: USD
amount: 264.19
name: BaseFare
- type: Taxes
currency: USD
amount: 35.21
name: Taxes
line_type: PRODUCT
- date: '2026-06-16'
date_time: '2026-06-16T15:48:32.422490956'
net_amount:
currency: USD
amount: 22.0
credit_card_info:
last4_digits: '4448'
first6_digits: '444444'
card_type: VISA
breakdowns:
- type: Agent assisted air purchase fee
currency: USD
amount: 22.0
name: Agent assisted air purchase fee
line_type: EGENCIA_FEE
document_type: RECEIPT
traveler_id: 7854234
central_bill: true
_links:
receipt_pdf:
href: https://apis.egencia.com/openconnect/api/v2/bookings/0000-3903-531/items/6a3170346cd5e06ad2673e0b/receipts/6a3170c7f91c659fa8355b41?traveler_id=7854234
booking_status: BOOKED
origin_destinations:
- segments:
- provider:
code: WN
name: Southwest Airlines
rules_and_regulations:
details:
- - Before Departure
- Changeable without penalty.
- Refundable without penalty.
rate_type:
name: PUBLIC
code: PUBLIC
status: BOOKED
co2_emission:
value: 618
unit: LB
equivalencies:
- type: SMART_PHONE_CHARGES
value: 35840.0
- type: HOMES_ELECTRICITY
value: 0.06
- type: SMARTPHONE_CHARGES
value: 35840.0
- type: HOME_ELECTRICITY
value: 0.06
- type: DISTANCE_DRIVEN_BY_CAR
value: 700.0
booking_class: Economy
departure:
location:
type: AIRPORT
code: HOU
name: Houston, TX, United States of America (HOU-William P. Hobby)
address:
country_code: US
city_name: Houston
date_time: '2026-09-08T09:35:00.000-05:00'
arrival:
location:
type: AIRPORT
code: LAX
name: Los Angeles, CA, United States of America (LAX-Los Angeles Intl.)
address:
country_code: US
city_name: Los Angeles
date_time: '2026-09-08T11:05:00.000-07:00'
operating_carrier:
name: Southwest Airlines
code: WN
number: '1942'
low_cost_carrier: false
marketing_carrier:
name: Southwest Airlines
code: WN
number: '1942'
low_cost_carrier: false
traveler_segment_info:
- traveler_id: 7854234
ticket:
number: '5262150903018'
ticket_number:
- '5262150903018'
_links:
self:
href: https://apis.egencia.com/openconnect/api/v1/bookings/0000-3903-531/items/6a3170346cd5e06ad2673e0b
trip:
href: https://www.egencia.com/trip-webapp/0000-3903-531?auth_gpid=64139
receipt:
href: https://apis.egencia.com/openconnect/api/v2/bookings/0000-3903-531/items/6a3170346cd5e06ad2673e0b/receipts
Expense message for a Flight booking (MultiCity):
description: Expense message for a Flight booking (MultiCity)
value:
uuid: 6ac27d6b-dc68-47fa-a9be-42795e5937b5
expense_id: FT-752942dc3b52d6d6a0cecb44020e102c153c59ee
expense_version: 4
point_of_sale:
country_code: US
company:
id: 64139
name: CaspianTestUSCompany
organization_parent_id: 6556964
travelers:
- id: 7805149
first_name: Test
last_name: User
email: test.user@example.com
preferred_language: en
custom_data_fields: []
booker:
id: 7805149
first_name: Test
last_name: User
email: test.user@example.com
is_agent: false
partner:
name: xxx
price:
currency: USD
amount: 1031.59
cost_to_customer: 1031.59
breakdowns:
- type: BASE
currency: USD
amount: 911.43
- type: TAXES
currency: USD
amount: 120.16
- type: CC_FEES
currency: USD
amount: 0.0
egencia_item_id: 68efb8024b169cd84f931833
egencia_trip_id: 0000-3673-471
egencia_trip_link: https://www.egencia.com/trip-webapp/0000-3673-471?auth_gpid=64139
approval_triggered: false
payment_method: COMPANY_FORM_OF_PAYMENT
credit_card:
last4_digits: '4242'
first6_digits: '424242'
expense_type: FLIGHT
gds_reference: ENPQZD
vendor_reference: KFQLGB
booking_reference: '21876264442'
custom_data_fields: []
policy_compliance:
is_compliant: true
booking_date_time: '2025-10-15T00:00:00.000Z'
cancellation_date_time: '2025-10-17T11:46:38.933Z'
receipt_info:
id: '112576'
status: AVAILABLE
version: 4
document_type: RECEIPT
_links:
receipt_pdf:
href: https://apis.egencia.com/openconnect/api/v1/bookings/0000-3673-471/items/68efb8024b169cd84f931833/receipts
booking_status: CANCELLED
origin_destinations:
- segments:
- provider:
code: AS
name: Alaska Airlines
rules_and_regulations:
details:
- '- Before Departure
- Changeable without penalty
- Refundable with a penalty: $737.00.
'
rate_type:
name: EGENCIA
code: EGENCIA
status: CANCELLED
co2_emission:
value: 1013
unit: LB
equivalencies:
- type: SMART_PHONE_CHARGES
value: 58752.0
- type: HOMES_ELECTRICITY
value: 0.09
- type: SMARTPHONE_CHARGES
value: 58752.0
- type: HOME_ELECTRICITY
value: 0.09
- type: DISTANCE_DRIVEN_BY_CAR
value: 1147.5
booking_class: Economy
departure:
location:
type: AIRPORT
code: JFK
name: New York, NY, United States of America (JFK-John F. Kennedy Intl.)
address:
country_code: US
city_name: New York
date_time: '2026-08-05T10:00:00.000-04:00'
arrival:
location:
type: AIRPORT
code: SAN
name: San Diego, CA, United States of America (SAN-San Diego Intl.)
address:
country_code: US
city_name: San Diego
date_time: '2026-08-05T12:54:00.000-07:00'
operating_carrier:
name: Alaska Airlines
code: AS
number: '35'
low_cost_carrier: false
marketing_carrier:
name: Alaska Airlines
code: AS
number: '35'
low_cost_carrier: false
traveler_segment_info:
- traveler_id: 7805149
ticket:
number: 0277340678555
- provider:
code: AS
name: Alaska Airlines
rules_and_regulations:
details:
- '- Before 05-Aug-2026 14:00
- Changeable without penalty
- Refundable with a penalty: $737.00.
'
rate_type:
name: EGENCIA
code: EGENCIA
status: CANCELLED
co2_emission:
value: 363
unit: LB
equivalencies:
- type: SMART_PHONE_CHARGES
value: 21120.0
- type: HOMES_ELECTRICITY
value: 0.03
- type: SMARTPHONE_CHARGES
value: 21120.0
- type: HOME_ELECTRICITY
value: 0.03
- type: DISTANCE_DRIVEN_BY_CAR
value: 412.5
booking_class: Economy
departure:
location:
type: AIRPORT
code: SAN
name: San Diego, CA, United States of America (SAN-San Diego Intl.)
address:
country_code: US
city_name: San Diego
date_time: '2026-08-05T16:49:00.000-07:00'
arrival:
location:
type: AIRPORT
code: SFO
name: San Francisco, CA, United States of America (SFO-San Francisco Intl.)
address:
country_code: US
city_name: San Francisco
date_time: '2026-08-05T18:29:00.000-07:00'
operating_carrier:
name: Alaska Airlines
code: AS
number: '3473'
low_cost_carrier: false
marketing_carrier:
name: Alaska Airlines
code: AS
number: '3473'
low_cost_carrier: false
traveler_segment_info:
- traveler_id: 7805149
ticket:
number: 0277340678555
- segments:
- provider:
code: AS
name: Alaska Airlines
rules_and_regulations:
details:
- - Changeable without penalty
- Refundable with a penalty from $753.00
rate_type:
name: EGENCIA
code: EGENCIA
status: CANCELLED
co2_emission:
value: 274
unit: LB
equivalencies:
- type: SMART_PHONE_CHARGES
value: 15872.0
- type: HOMES_ELECTRICITY
value: 0.02
- type: SMARTPHONE_CHARGES
value: 15872.0
- type: HOME_ELECTRICITY
value: 0.02
- type: DISTANCE_DRIVEN_BY_CAR
value: 310.0
booking_class: Economy
departure:
location:
type: AIRPORT
code: SFO
name: San Francisco, CA, United States of America (SFO-San Francisco Intl.)
address:
country_code: US
city_name: San Francisco
date_time: '2026-08-09T19:00:00.000-07:00'
arrival:
location:
type: AIRPORT
code: LAX
name: Los Angeles, CA, United States of America (LAX-Los Angeles Intl.)
address:
country_code: US
city_name: Los Angeles
date_time: '2026-08-09T20:37:00.000-07:00'
operating_carrier:
name: Alaska Airlines
code: AS
number: '3460'
low_cost_carrier: false
marketing_carrier:
name: Alaska Airlines
code: AS
number: '3460'
low_cost_carrier: false
traveler_segment_info:
- traveler_id: 7805149
ticket:
number: 0277340678555
- segments:
- provider:
code: AS
name: Alaska Airlines
rules_and_regulations:
details:
- - Changeable without penalty
- Refundable with a penalty from $753.00
rate_type:
name: EGENCIA
code: EGENCIA
status: CANCELLED
co2_emission:
value: 301
unit: LB
equivalencies:
- type: SMART_PHONE_CHARGES
value: 17536.0
- type: HOMES_ELECTRICITY
value: 0.03
- type: SMARTPHONE_CHARGES
value: 17536.0
- type: HOME_ELECTRICITY
value: 0.03
- type: DISTANCE_DRIVEN_BY_CAR
value: 342.5
booking_class: Economy
departure:
location:
type: AIRPORT
code: LAX
name: Los Angeles, CA, United States of America (LAX-Los Angeles Intl.)
address:
country_code: US
city_name: Los Angeles
date_time: '2026-08-10T10:40:00.000-07:00'
arrival:
location:
type: AIRPORT
code: BOI
name: Boise, ID, United States of America (BOI)
address:
country_code: US
city_name: Boise
date_time: '2026-08-10T13:44:00.000-06:00'
operating_carrier:
name: Alaska Airlines
code: AS
number: '2141'
low_cost_carrier: false
marketing_carrier:
name: Alaska Airlines
code: AS
number: '2141'
low_cost_carrier: false
traveler_segment_info:
- traveler_id: 7805149
ticket:
number: 0277340678555
- provider:
code: AS
name: Alaska Airlines
rules_and_regulations:
details:
- - Changeable without penalty
- Refundable with a penalty from $753.00
rate_type:
name: EGENCIA
code: EGENCIA
status: CANCELLED
co2_emission:
value: 327
unit: LB
equivalencies:
- type: SMART_PHONE_CHARGES
value: 18944.0
- type: HOMES_ELECTRICITY
value: 0.03
- type: SMARTPHONE_CHARGES
value: 18944.0
- type: HOME_ELECTRICITY
value: 0.03
- type: DISTANCE_DRIVEN_BY_CAR
value: 370.0
booking_class: Economy
departure:
location:
type: AIRPORT
code: BOI
name: Boise, ID, United States of America (BOI)
address:
country_code: US
city_name: Boise
date_time: '2026-08-10T17:44:00.000-06:00'
arrival:
location:
type: AIRPORT
code: PHX
name: Phoenix, AZ, United States of America (PHX-Sky Harbor Intl.)
address:
country_code: US
city_name: Phoenix
date_time: '2026-08-10T18:56:00.000-07:00'
operating_carrier:
name: Alaska Airlines
code: AS
number: '2099'
low_cost_carrier: false
marketing_carrier:
name: Alaska Airlines
code: AS
number: '2099'
low_cost_carrier: false
traveler_segment_info:
- traveler_id: 7805149
ticket:
number: 0277340678555
ticket_number:
- 0277340678555
_links:
self:
href: https://apis.egencia.com/openconnect/api/v1/bookings/0000-3673-471/items/68efb8024b169cd84f931833
trip:
href: https://www.egencia.com/trip-webapp/0000-3673-471?auth_gpid=64139
receipt:
href: https://apis.egencia.com/openconnect/api/v1/bookings/0000-3673-471/items/68efb8024b169cd84f931833/receipts
Expense message for a Flight booking (One Way) without receipt:
description: Expense message for a Flight booking (One Way) without receipt
value:
uuid: 505dd3d9-81b7-4e72-a1c7-230cbd985c48
expense_id: FT-a5c84520149204cef5e5db669398ca90dcef4a68
expense_version: 1
point_of_sale:
country_code: FR
company:
id: 64143
name: caspianTestCompany_FR
organization_parent_id: 6556965
travelers:
- id: 7807459
first_name: Test
last_name: User
email: test.user@example.com
preferred_language: fr
custom_data_fields:
- label: Main cost centre
value: caspianTestCompany_FR
- label: Employee ID
value: '2222'
booker:
id: 7807459
first_name: Test
last_name: User
email: test.user@example.com
is_agent: false
partner:
name: xxx
price:
currency: EUR
amount: 183.82
cost_to_customer: 183.82
breakdowns:
- type: BASE
currency: EUR
amount: 128.0
- type: TAXES
currency: EUR
amount: 55.82
egencia_item_id: 68ed1a81772f0921253d0dcf
egencia_trip_id: 2000-3179-692
egencia_trip_link: https://www.egencia.eu/trip-webapp/2000-3179-692?auth_gpid=64143
approval_triggered: false
payment_method: CREDIT_CARD
credit_card:
last4_digits: '4242'
first6_digits: '424242'
expense_type: FLIGHT
gds_reference: XWKPET
vendor_reference: XWKPET
booking_reference: XWKPET
custom_data_fields:
- label: Main cost centre
value: caspianTestCompany_FR
- label: Employee ID
value: '2222'
policy_compliance:
is_compliant: true
booking_date_time: '2025-10-14T00:00:00.000Z'
booking_status: BOOKED
origin_destinations:
- segments:
- provider:
code: TP
name: TAP Portugal
rate_type:
name: EGENCIA
code: EGENCIA
status: BOOKED
co2_emission:
value: 180
unit: KG
equivalencies:
- type: SMART_PHONE_CHARGES
value: 23040.0
- type: HOMES_ELECTRICITY
value: 0.04
- type: SMARTPHONE_CHARGES
value: 23040.0
- type: HOME_ELECTRICITY
value: 0.04
- type: DISTANCE_DRIVEN_BY_CAR
value: 724.05
booking_class: Economy
departure:
location:
type: AIRPORT
code: LIS
name: Lisbonne, Portugal (LIS-Humberto Delgado)
address:
country_code: PT
city_name: Lisbonne
date_time: '2026-05-14T15:25:00.000+01:00'
arrival:
location:
type: AIRPORT
code: ORY
name: Paris, France (ORY-Orly)
address:
country_code: FR
city_name: Paris
date_time: '2026-05-14T18:50:00.000+02:00'
marketing_carrier:
name: TAP Portugal
code: TP
number: '436'
low_cost_carrier: false
traveler_segment_info:
- traveler_id: 7807459
ticket_number: []
_links:
self:
href: https://apis.egencia.eu/openconnect/api/v1/bookings/2000-3179-692/items/68ed1a81772f0921253d0dcf
trip:
href: https://www.egencia.eu/trip-webapp/2000-3179-692?auth_gpid=64143
Expense message for a Flight booking (Round Trip) with receipt:
description: Expense message for a Flight booking (Round Trip) with receipt
value:
uuid: ca0cd1ce-073c-4b5f-8820-d1ac8757a044
expense_id: FT-406618b8087a39e8543c52d2ec9e81fbc68b189f
expense_version: 2
point_of_sale:
country_code: US
company:
id: 64139
name: CaspianTestUSCompany
organization_parent_id: 6556964
travelers:
- id: 7805149
first_name: Test
last_name: User
email: test.user@example.com
preferred_language: en
custom_data_fields: []
booker:
id: 7805149
first_name: Test
last_name: User
email: test.user@example.com
is_agent: false
partner:
name: xxx
price:
currency: USD
amount: 416.96
cost_to_customer: 416.96
breakdowns:
- type: BASE
currency: USD
amount: 359.4
- type: TAXES
currency: USD
amount: 57.56
egencia_item_id: 68dd279057aeee540654b34e
egencia_trip_id: 0000-3658-753
egencia_trip_link: https://www.egencia.com/trip-webapp/0000-3658-753?auth_gpid=64139
approval_triggered: false
payment_method: COMPANY_FORM_OF_PAYMENT
expense_type: FLIGHT
gds_reference: AS8B7C
vendor_reference: AS8B7C
booking_reference: '21875895050'
custom_data_fields: []
policy_compliance:
is_compliant: true
booking_date_time: '2025-10-01T00:00:00.000Z'
receipt_info:
id: '95827'
status: AVAILABLE
version: 2
receipt_number: '21875895050'
receipt_date: '2025-10-03T12:00:09.071+00:00'
total_amount:
currency: USD
amount: 416.96
payments:
- date: '2025-10-01T13:08:00.000Z'
net_amount:
currency: USD
amount: 416.96
credit_card_info:
last4_digits: '4448'
first6_digits: '444444'
card_type: 'Central bill: Visa'
breakdowns:
- type: Base fare
currency: USD
amount: 359.4
- type: Taxes & airline fees
currency: USD
amount: 57.56
document_type: RECEIPT
central_bill: true
_links:
receipt_pdf:
href: https://apis.egencia.com/openconnect/api/v1/bookings/0000-3658-753/items/68dd279057aeee540654b34e/receipts
booking_status: BOOKED
origin_destinations:
- segments:
- provider:
code: WN
name: Southwest Airlines
rules_and_regulations:
details:
- - Before Departure
- Changeable without penalty
- Non-refundable
rate_type:
name: PUBLIC
code: PUBLIC
status: BOOKED
co2_emission:
value: 618
unit: LB
equivalencies:
- type: SMART_PHONE_CHARGES
value: 35840.0
- type: HOMES_ELECTRICITY
value: 0.06
- type: SMARTPHONE_CHARGES
value: 35840.0
- type: HOME_ELECTRICITY
value: 0.06
- type: DISTANCE_DRIVEN_BY_CAR
value: 700.0
booking_class: Economy
departure:
location:
type: AIRPORT
code: LAX
name: Los Angeles, CA, United States of America (LAX-Los Angeles Intl.)
address:
country_code: US
city_name: Los Angeles
date_time: '2025-10-08T05:10:00.000-07:00'
arrival:
location:
type: AIRPORT
code: HOU
name: Houston, TX, United States of America (HOU-William P. Hobby)
address:
country_code: US
city_name: Houston
date_time: '2025-10-08T10:25:00.000-05:00'
operating_carrier:
name: Southwest Airlines
code: WN
number: '3417'
low_cost_carrier: false
marketing_carrier:
name: Southwest Airlines
code: WN
number: '3417'
low_cost_carrier: false
traveler_segment_info:
- traveler_id: 7805149
ticket:
number: '5262100101292'
- segments:
- provider:
code: WN
name: Southwest Airlines
rules_and_regulations:
details:
- - Before 08-Oct-2025 12:10
- Changeable without penalty
- Non-refundable
rate_type:
name: PUBLIC
code: PUBLIC
status: BOOKED
co2_emission:
value: 618
unit: LB
equivalencies:
- type: SMART_PHONE_CHARGES
value: 35840.0
- type: HOMES_ELECTRICITY
value: 0.06
- type: SMARTPHONE_CHARGES
value: 35840.0
- type: HOME_ELECTRICITY
value: 0.06
- type: DISTANCE_DRIVEN_BY_CAR
value: 700.0
booking_class: Economy
departure:
location:
type: AIRPORT
code: HOU
name: Houston, TX, United States of America (HOU-William P. Hobby)
address:
country_code: US
city_name: Houston
date_time: '2025-10-11T16:15:00.000-05:00'
arrival:
location:
type: AIRPORT
code: LAX
name: Los Angeles, CA, United States of America (LAX-Los Angeles Intl.)
address:
country_code: US
city_name: Los Angeles
date_time: '2025-10-11T17:50:00.000-07:00'
operating_carrier:
name: Southwest Airlines
code: WN
number: '2967'
low_cost_carrier: false
marketing_carrier:
name: Southwest Airlines
code: WN
number: '2967'
low_cost_carrier: false
traveler_segment_info:
- traveler_id: 7805149
ticket:
number: '5262100101292'
ticket_number:
- '5262100101292'
_links:
self:
href: https://apis.egencia.com/openconnect/api/v1/bookings/0000-3658-753/items/68dd279057aeee540654b34e
trip:
href: https://www.egencia.com/trip-webapp/0000-3658-753?auth_gpid=64139
receipt:
href: https://apis.egencia.com/openconnect/api/v1/bookings/0000-3658-753/items/68dd279057aeee540654b34e/receipts
Expense message for a Flight booking with stopover:
description: Expense message for a Flight booking with stopover
value:
uuid: 418bf0ac-b434-4ad1-907d-19272700ff7c
expense_id: FT-349df584bdb89b6fd98cb242e33274b8ff022068
expense_version: 1
point_of_sale:
country_code: FR
company:
id: 64143
name: caspianTestCompany_FR
organization_parent_id: 6556965
travelers:
- id: 7807459
first_name: Test
last_name: User
email: test.user@example.com
preferred_language: fr
custom_data_fields:
- label: Main cost centre
value: CC1
- label: Employee ID
value: '2222'
booker:
id: 7807459
first_name: Test
last_name: User
email: test.user@example.com
is_agent: false
partner:
name: xxx
price:
currency: EUR
amount: 233.02
cost_to_customer: 233.02
breakdowns:
- type: BASE
currency: EUR
amount: 144.0
- type: TAXES
currency: EUR
amount: 89.02
egencia_item_id: 68ee659b3af032c33e35e4c7
egencia_trip_id: 2000-3180-871
egencia_trip_link: https://www.egencia.eu/trip-webapp/2000-3180-871?auth_gpid=64143
approval_triggered: false
payment_method: CREDIT_CARD
credit_card:
last4_digits: '4242'
first6_digits: '424242'
expense_type: FLIGHT
gds_reference: XWQPU3
vendor_reference: XWQPU3
booking_reference: XWQPU3
custom_data_fields:
- label: Main cost centre
value: CC1
- label: Employee ID
value: '2222'
policy_compliance:
is_compliant: true
booking_date_time: '2025-10-14T00:00:00.000Z'
booking_status: BOOKED
origin_destinations:
- segments:
- provider:
code: TP
name: TAP Portugal
rate_type:
name: EGENCIA
code: EGENCIA
status: BOOKED
co2_emission:
value: 160
unit: KG
equivalencies:
- type: SMART_PHONE_CHARGES
value: 20480.0
- type: HOMES_ELECTRICITY
value: 0.03
- type: SMARTPHONE_CHARGES
value: 20480.0
- type: HOME_ELECTRICITY
value: 0.03
- type: DISTANCE_DRIVEN_BY_CAR
value: 643.6
booking_class: Economy
departure:
location:
type: AIRPORT
code: LGW
name: Londres, Royaume-Uni (LGW-Gatwick)
address:
country_code: GB
city_name: Londres
date_time: '2026-06-18T12:05:00.000+01:00'
arrival:
location:
type: AIRPORT
code: OPO
name: Porto, Portugal (OPO-Dr. Francisco Sá Carneiro)
address:
country_code: PT
city_name: Porto
date_time: '2026-06-18T14:30:00.000+01:00'
marketing_carrier:
name: TAP Portugal
code: TP
number: '1329'
low_cost_carrier: false
traveler_segment_info:
- traveler_id: 7807459
- provider:
code: TP
name: TAP Portugal
rate_type:
name: EGENCIA
code: EGENCIA
status: BOOKED
co2_emission:
value: 63
unit: KG
equivalencies:
- type: SMART_PHONE_CHARGES
value: 8064.0
- type: HOMES_ELECTRICITY
value: 0.01
- type: SMARTPHONE_CHARGES
value: 8064.0
- type: HOME_ELECTRICITY
value: 0.01
- type: DISTANCE_DRIVEN_BY_CAR
value: 253.42
booking_class: Economy
departure:
location:
type: AIRPORT
code: OPO
name: Porto, Portugal (OPO-Dr. Francisco Sá Carneiro)
address:
country_code: PT
city_name: Porto
date_time: '2026-06-18T16:00:00.000+01:00'
arrival:
location:
type: AIRPORT
code: LIS
name: Lisbonne, Portugal (LIS-Humberto Delgado)
address:
country_code: PT
city_name: Lisbonne
date_time: '2026-06-18T17:00:00.000+01:00'
marketing_carrier:
name: TAP Portugal
code: TP
number: '1929'
low_cost_carrier: false
traveler_segment_info:
- traveler_id: 7807459
ticket_number: []
_links:
self:
href: https://apis.egencia.eu/openconnect/api/v1/bookings/2000-3180-871/items/68ee659b3af032c33e35e4c7
trip:
href: https://www.egencia.eu/trip-webapp/2000-3180-871?auth_gpid=64143
Expense message for a Flight cancellation:
description: Expense message for a Flight cancellation
value:
uuid: 0ade9441-49ec-4095-b72b-d0df18a7c557
expense_id: FT-25f47f9e10be25e9c3cc3a930edaec2531785afb
expense_version: 3
point_of_sale:
country_code: US
company:
id: 64139
name: CaspianTestUSCompany
organization_parent_id: 6556964
travelers:
- id: 7805149
first_name: Test
last_name: User
email: test.user@example.com
preferred_language: en
custom_data_fields: []
booker:
id: 7805149
first_name: Test
last_name: User
email: test.user@example.com
is_agent: false
partner:
name: xxx
price:
currency: USD
amount: 228.48
cost_to_customer: 228.48
breakdowns:
- type: BASE
currency: USD
amount: 198.31
- type: TAXES
currency: USD
amount: 30.17
egencia_item_id: 68de9fed57aeee540654c683
egencia_trip_id: 0000-3660-438
egencia_trip_link: https://www.egencia.com/trip-webapp/0000-3660-438?auth_gpid=64139
approval_triggered: false
payment_method: COMPANY_FORM_OF_PAYMENT
expense_type: FLIGHT
gds_reference: AYHVKF
vendor_reference: AYHVKF
booking_reference: '21875919757'
custom_data_fields: []
policy_compliance:
is_compliant: true
booking_date_time: '2025-10-02T00:00:00.000Z'
cancellation_date_time: '2025-10-02T15:57:03.610Z'
receipt_info:
id: '97626'
status: AVAILABLE
version: 2
receipt_number: '21875919757'
receipt_date: '2025-10-04T12:00:12.324+00:00'
total_amount:
currency: USD
amount: 228.48
payments:
- date: '2025-10-02T15:54:00.000Z'
net_amount:
currency: USD
amount: 228.48
credit_card_info:
last4_digits: '4448'
first6_digits: '444444'
card_type: 'Central bill: Visa'
breakdowns:
- type: Base fare
currency: USD
amount: 198.31
- type: Taxes & airline fees
currency: USD
amount: 30.17
document_type: RECEIPT
central_bill: true
_links:
receipt_pdf:
href: https://apis.egencia.com/openconnect/api/v1/bookings/0000-3660-438/items/68de9fed57aeee540654c683/receipts
booking_status: CANCELLED
origin_destinations:
- segments:
- provider:
code: WN
name: Southwest Airlines
rules_and_regulations:
details:
- - Before Departure
- Changeable without penalty
- Non-refundable
rate_type:
name: PUBLIC
code: PUBLIC
status: CANCELLED
co2_emission:
value: 778
unit: LB
equivalencies:
- type: SMART_PHONE_CHARGES
value: 45184.0
- type: HOMES_ELECTRICITY
value: 0.07
- type: SMARTPHONE_CHARGES
value: 45184.0
- type: HOME_ELECTRICITY
value: 0.07
- type: DISTANCE_DRIVEN_BY_CAR
value: 882.5
booking_class: Economy
departure:
location:
type: AIRPORT
code: LAX
name: Los Angeles, CA, United States of America (LAX-Los Angeles Intl.)
address:
country_code: US
city_name: Los Angeles
date_time: '2025-10-15T12:45:00.000-07:00'
arrival:
location:
type: AIRPORT
code: MDW
name: Chicago, IL, United States of America (MDW-Midway Intl.)
address:
country_code: US
city_name: Chicago
date_time: '2025-10-15T18:40:00.000-05:00'
operating_carrier:
name: Southwest Airlines
code: WN
number: '834'
low_cost_carrier: false
marketing_carrier:
name: Southwest Airlines
code: WN
number: '834'
low_cost_carrier: false
traveler_segment_info:
- traveler_id: 7805149
ticket:
number: '5262100103551'
ticket_number:
- '5262100103551'
_links:
self:
href: https://apis.egencia.com/openconnect/api/v1/bookings/0000-3660-438/items/68de9fed57aeee540654c683
trip:
href: https://www.egencia.com/trip-webapp/0000-3660-438?auth_gpid=64139
receipt:
href: https://apis.egencia.com/openconnect/api/v1/bookings/0000-3660-438/items/68de9fed57aeee540654c683/receipts
Expense message for a Flight cancellation with penalty:
description: Expense message for a Flight cancellation with penalty
value:
uuid: 7f6bf1da-9c5a-445a-9ae3-5f3737fab82a
expense_id: FT-933423c1b8355f98ae0c31be51335b97c602f727
expense_version: 5
point_of_sale:
country_code: DE
company:
id: 58657
name: CaspianTestDECompany
organization_parent_id: 1003617
travelers:
- id: 38129595
first_name: Test
last_name: User
email: test.user@example.com
preferred_language: de
custom_data_fields:
- label: Department code
value: DE24
- label: Cost Center
value: DE241404
- label: Employee ID
value: '50026883'
- label: Employee Subgroup
value: O
- label: Job Function
value: DE
- label: Reason for Travel
value: Service Cranes
is_guest: false
booker:
id: 38129595
first_name: Test
last_name: User
email: test.user@example.com
is_agent: false
partner:
name: xxx
price:
currency: EUR
amount: 817.02
cost_to_customer: 679.4
breakdowns:
- type: BASE
currency: EUR
amount: 401.0
- type: TAXES
currency: EUR
amount: 416.02
refunds:
- type: REFUNDABLE_TAXES
currency: EUR
amount: 407.4
- type: BASE
currency: EUR
amount: 401.0
- type: REFUND
currency: EUR
amount: 679.4
penalties:
- type: PENALTY
currency: EUR
amount: 129.0
egencia_item_id: 6a0edeecaedef426391613ba
egencia_trip_id: 0611-0990-677
egencia_trip_link: https://www.egencia.eu/trip-webapp/0611-0990-677?auth_gpid=58657
approval_triggered: false
payment_method: CREDIT_CARD
expense_type: FLIGHT
gds_reference: XPJ2ZT
vendor_reference: XPJ2ZT
booking_reference: XPJ2ZT
custom_data_fields:
- label: Department code
value: DE24
- label: Cost Center
value: DE241404
- label: Employee ID
value: '50026883'
- label: Employee Subgroup
value: O
- label: Job Function
value: DE
- label: Reason for Travel
value: Service Cranes
policy_compliance:
is_compliant: true
booking_date_time: '2026-05-21T12:31:27.000+02:00'
cancellation_date_time: '2026-06-15T10:08:09.307Z'
receipt_provision_available: true
receipt_info:
id: GEI12172178
status: AVAILABLE
receipt_date: '2026-05-21'
total_amount:
currency: EUR
amount: 824.16
payments:
- date: '2026-05-21'
net_amount:
currency: EUR
amount: 817.02
credit_card_info:
last4_digits: 0814
first6_digits: '553422'
card_type: MASTER_CARD
breakdowns:
- type: BASE
currency: EUR
amount: 817.02
- type: TAX
currency: EUR
amount: 0.0
line_type: PRODUCT
- date: '2026-05-21'
net_amount:
currency: EUR
amount: 7.14
credit_card_info:
last4_digits: 0814
first6_digits: '553422'
card_type: MASTER_CARD
breakdowns:
- type: BASE
currency: EUR
amount: 6.0
- type: TAX
currency: EUR
amount: 1.14
line_type: EGENCIA_FEE
document_type: INVOICE
traveler_id: 38129595
central_bill: true
_links:
receipt_pdf:
href: https://apis.egencia.eu/openconnect/api/v2/bookings/0611-0990-677/items/6a0edeecaedef426391613ba/receipts/GEI12172178?traveler_id=38129595
booking_status: CANCELLED
origin_destinations:
- segments:
- provider:
code: LH
name: Lufthansa
rate_type:
name: PUBLIC
code: PUBLIC
status: CANCELLED
co2_emission:
value: 42
unit: KG
equivalencies:
- type: SMART_PHONE_CHARGES
value: 5376.0
- type: HOMES_ELECTRICITY
value: 0.01
- type: SMARTPHONE_CHARGES
value: 5376.0
- type: HOME_ELECTRICITY
value: 0.01
- type: DISTANCE_DRIVEN_BY_CAR
value: 168.95
booking_class: Economy
departure:
location:
type: AIRPORT
code: DUS
name: Düsseldorf, Germany (DUS-Düsseldorf Intl.)
address:
country_code: DE
city_name: Düsseldorf
date_time: '2026-06-22T15:10:00.000+02:00'
arrival:
location:
type: AIRPORT
code: FRA
name: Frankfurt, Germany (FRA-Frankfurt Intl.)
address:
country_code: DE
city_name: Frankfurt
date_time: '2026-06-22T16:00:00.000+02:00'
marketing_carrier:
name: Lufthansa
code: LH
number: '75'
low_cost_carrier: false
traveler_segment_info:
- traveler_id: 38129595
ticket:
number: 0714815783755
- provider:
code: ET
name: Ethiopian Airlines
rate_type:
name: PUBLIC
code: PUBLIC
status: CANCELLED
co2_emission:
value: 626
unit: KG
equivalencies:
- type: SMART_PHONE_CHARGES
value: 80128.0
- type: HOMES_ELECTRICITY
value: 0.13
- type: SMARTPHONE_CHARGES
value: 80128.0
- type: HOME_ELECTRICITY
value: 0.13
- type: DISTANCE_DRIVEN_BY_CAR
value: 2518.09
booking_class: Economy
departure:
location:
type: AIRPORT
code: FRA
name: Frankfurt, Germany (FRA-Frankfurt Intl.)
address:
country_code: DE
city_name: Frankfurt
date_time: '2026-06-22T22:05:00.000+02:00'
arrival:
location:
type: AIRPORT
code: ADD
name: Addis Ababa, Ethiopia (ADD-Bole Intl.)
address:
country_code: ET
city_name: Addis Ababa
date_time: '2026-06-23T05:55:00.000+03:00'
marketing_carrier:
name: Ethiopian Airlines
code: ET
number: '707'
low_cost_carrier: false
traveler_segment_info:
- traveler_id: 38129595
ticket:
number: 0714815783755
- provider:
code: ET
name: Ethiopian Airlines
rate_type:
name: PUBLIC
code: PUBLIC
status: CANCELLED
co2_emission:
value: 421
unit: KG
equivalencies:
- type: SMART_PHONE_CHARGES
value: 53888.0
- type: HOMES_ELECTRICITY
value: 0.08
- type: SMARTPHONE_CHARGES
value: 53888.0
- type: HOME_ELECTRICITY
value: 0.08
- type: DISTANCE_DRIVEN_BY_CAR
value: 1693.47
booking_class: Economy
departure:
location:
type: AIRPORT
code: ADD
name: Addis Ababa, Ethiopia (ADD-Bole Intl.)
address:
country_code: ET
city_name: Addis Ababa
date_time: '2026-06-23T08:45:00.000+03:00'
arrival:
location:
type: AIRPORT
code: PNR
name: Pointe Noire, Republik Kongo (PNR-Antionio Agostinho Neto Intl.)
address:
country_code: CG
city_name: Pointe Noire
date_time: '2026-06-23T13:15:00.000+01:00'
marketing_carrier:
name: Ethiopian Airlines
code: ET
number: '861'
low_cost_carrier: false
traveler_segment_info:
- traveler_id: 38129595
ticket:
number: 0714815783755
ticket_number:
- 0714815783755
_links:
self:
href: https://apis.egencia.eu/openconnect/api/v1/bookings/0611-0990-677/items/6a0edeecaedef426391613ba
trip:
href: https://www.egencia.eu/trip-webapp/0611-0990-677?auth_gpid=58657
receipt:
href: https://apis.egencia.eu/openconnect/api/v2/bookings/0611-0990-677/items/6a0edeecaedef426391613ba/receipts
Expense message for a Flight exchange:
description: Expense message for a Flight exchange
value:
uuid: df91c288-e016-499e-9a10-3c2c1954a689
expense_id: FT-84b0693167c0a56776ddd48115d1cd5385317428
expense_version: 4
point_of_sale:
country_code: US
company:
id: 64139
name: CaspianTestUSCompany
organization_parent_id: 6556964
travelers:
- id: 7805149
first_name: Test
last_name: User
email: test.user@example.com
preferred_language: en
custom_data_fields: []
booker:
id: 7805149
first_name: Test
last_name: User
email: test.user@example.com
is_agent: false
partner:
name: xxx
price:
currency: USD
amount: 208.48
cost_to_customer: 208.48
breakdowns:
- type: BASE
currency: USD
amount: 179.7
- type: TAXES
currency: USD
amount: 28.78
egencia_item_id: 68dd46b557aeee540654b3ab
egencia_trip_id: 0000-3658-765
egencia_trip_link: https://www.egencia.com/trip-webapp/0000-3658-765?auth_gpid=64139
approval_triggered: false
payment_method: COMPANY_FORM_OF_PAYMENT
expense_type: FLIGHT
gds_reference: ASQWWO
vendor_reference: ASQWWO
booking_reference: '21875898738'
custom_data_fields: []
policy_compliance:
is_compliant: true
booking_date_time: '2025-10-01T00:00:00.000Z'
receipt_info:
id: '95845'
status: AVAILABLE
version: 2
receipt_number: '21875898738'
receipt_date: '2025-10-03T12:00:09.216+00:00'
total_amount:
currency: USD
amount: 208.48
payments:
- date: '2025-10-01T15:21:00.000Z'
net_amount:
currency: USD
amount: 208.48
credit_card_info:
last4_digits: '4448'
first6_digits: '444444'
card_type: 'Central bill: Visa'
breakdowns:
- type: Base fare
currency: USD
amount: 179.7
- type: Taxes & airline fees
currency: USD
amount: 28.78
document_type: RECEIPT
central_bill: true
_links:
receipt_pdf:
href: https://apis.egencia.com/openconnect/api/v1/bookings/0000-3658-765/items/68dd46b557aeee540654b3ab/receipts
booking_status: BOOKED
origin_destinations:
- segments:
- provider:
code: WN
name: Southwest Airlines
rate_type:
name: PUBLIC
code: PUBLIC
status: BOOKED
co2_emission:
value: 618
unit: LB
equivalencies:
- type: SMART_PHONE_CHARGES
value: 35840.0
- type: HOMES_ELECTRICITY
value: 0.06
- type: SMARTPHONE_CHARGES
value: 35840.0
- type: HOME_ELECTRICITY
value: 0.06
- type: DISTANCE_DRIVEN_BY_CAR
value: 700.0
booking_class: Economy
departure:
location:
type: AIRPORT
code: LAX
name: Los Angeles, CA, United States of America (LAX-Los Angeles Intl.)
address:
country_code: US
city_name: Los Angeles
date_time: '2025-10-15T13:00:00.000-07:00'
arrival:
location:
type: AIRPORT
code: HOU
name: Houston, TX, United States of America (HOU-William P. Hobby)
address:
country_code: US
city_name: Houston
date_time: '2025-10-15T18:15:00.000-05:00'
operating_carrier:
name: Southwest Airlines
code: WN
number: '2917'
low_cost_carrier: false
marketing_carrier:
name: Southwest Airlines
code: WN
number: '2917'
low_cost_carrier: false
traveler_segment_info:
- traveler_id: 7805149
ticket:
number: '5262100114150'
prior_number: '5262100101296'
ticket_number:
- '5262100114150'
_links:
self:
href: https://apis.egencia.com/openconnect/api/v1/bookings/0000-3658-765/items/68dd46b557aeee540654b3ab
trip:
href: https://www.egencia.com/trip-webapp/0000-3658-765?auth_gpid=64139
receipt:
href: https://apis.egencia.com/openconnect/api/v1/bookings/0000-3658-765/items/68dd46b557aeee540654b3ab/receipts
Expense message for a Hotel booking:
description: Expense message for a Hotel booking
value:
uuid: 109279f6-c8d8-4a7b-9630-b32e3ec690e2
expense_id: HL-9512476cd78c1e782f83eea5df8b09c2fba8edf4
expense_version: 1
point_of_sale:
country_code: GB
policy_compliance:
is_compliant: true
company:
id: 21053
name: Eastman Test Company
organization_parent_id: 21053
partner_customer_code: JE3B
travelers:
- id: 5328422
first_name: Test
is_guest: false
last_name: User
email: test.user@example.com
preferred_language: fr
booker:
email: test.user@example.com
first_name: Test
last_name: User
id: 5328422
is_agent: false
partner:
name: xxx
approval_triggered: false
price:
currency: EUR
amount: 66.6
cost_to_customer: 66.6
breakdowns:
- type: BASE
currency: EUR
amount: 62.24
breakdowns:
- amount: 62.24
currency: EUR
type: Mo, 7/10
- type: Taxes & Fees
currency: EUR
amount: 4.36
egencia_trip_id: 0600-2514-009
egencia_trip_link: https://www.egencia.eu/trip-webapp/0600-2514-009?auth_gpid=21053
booking_status: BOOKED
expense_type: HOTEL
gds_reference: 1357091856(24)
vendor_reference: vend123
booking_reference: '58006903706'
receipt_provision_available: false
custom_data_fields:
- label: Division
value: '31013281'
- label: Employee ID
value: '10026285'
rate_type:
name: EXPEDIA
code: EXPEDIA
rules_and_regulations:
details:
- Stornierungen und onderungen
- Das Hotel berechnet keine Gebohr for Stornierungen vor dem 23:59 Uhr Ortszeit am 06/10/2019.
- For Stornierungen und onderungen, die nach 23:59 Uhr Ortszeit am 06/10/2019 vorgenommen werden, berechnet das Hotel eine Gebohr in Hohe von 80% des Buchungsbetrages.
check_in: '2019-10-07T00:00:00.000+02:00'
check_out: '2019-10-08T00:00:00.000+02:00'
location:
type: HOTEL
name: Gasthaus Goldener Hirsch
address:
street_name: An der Hasel 91-93
country_name: German
country_code: DEU
city_name: Suhl
state_province_name: Germany Province
postal_code: '98527'
star_rating: '4.0'
provider: Expedia
property_id: '1401473778'
booking_date_time: '2021-09-30T12:35:20.000Z'
_links:
self:
href: https://apis.egencia.eu/openconnect/api/v1/bookings/0600-2514-009/items/6450a5b869d5bd432ab9cca8
trip:
href: https://www.egencia.eu/trip-webapp/0600-2514-009?auth_gpid=21053
Expense message for a Hotel booking with receipt:
description: Expense message for a Hotel booking with receipt
value:
uuid: 9bd14da0-f75f-426f-9fa4-33d0af5e6905
expense_id: HL-fb551544155bdfa34e3130ad1f8a28ab3f553520
expense_version: 3
point_of_sale:
country_code: US
company:
id: 48548
name: Hotel Service Level Acceptance
organization_parent_id: 48548
travelers:
- id: 6482234
first_name: Test
is_guest: true
last_name: User
email: test.user@example.com
preferred_language: en
custom_data_fields:
- label: Department code
value: 5555522 - Sales Team
- label: Approved Travel Request ID
value: test cvalue
booker:
id: 6482234
first_name: Test
last_name: User
email: test.user@example.com
is_agent: false
partner:
name: xxx
price:
currency: USD
amount: 233.94
cost_to_customer: 233.94
breakdowns:
- type: TOTAL_BASE
currency: USD
amount: 209.17
breakdowns:
- type: Wed, 11/5
currency: USD
amount: 209.17
- type: Taxes & Fees
currency: USD
amount: 24.77
penalties:
- type: Cancellation penalty
currency: USD
amount: 233.94
egencia_item_id: 69091e07a314e1fa17f50214
egencia_trip_id: 0000-3691-591
egencia_trip_link: https://www.egencia.com/trip-webapp/0000-3691-591?auth_gpid=48548
approval_triggered: false
payment_method: CREDIT_CARD
credit_card:
last4_digits: '4448'
first6_digits: '444444'
expense_type: HOTEL
gds_reference: '7331635082143'
booking_reference: '21876679960'
custom_data_fields:
- label: Department code
value: 5555522 - Sales Team
- label: Approved Travel Request ID
value: test cvalue
rate_type:
name: EXPEDIA
code: EXPEDIA
rules_and_regulations:
details:
- Cancellation and Changes
-
- '- This reservation is non-refundable and cannot be modified.
'
-
policy_compliance:
is_compliant: true
booking_date_time: '2025-11-03T00:00:00.000Z'
cancellation_date_time: '2025-11-03T21:26:54.729Z'
receipt_provision_available: true
receipt_info:
id: '133582'
status: AVAILABLE
version: 1
receipt_number: '21876679960'
receipt_date: '2025-11-04T12:00:35.258+00:00'
total_amount:
currency: USD
amount: 233.94
payments:
- date: '2025-11-03T13:26:31.550Z'
net_amount:
currency: USD
amount: 233.94
credit_card_info:
last4_digits: '4448'
first6_digits: '444444'
card_type: Visa
breakdowns:
- type: 11/05/2025
currency: USD
amount: 209.17
- type: Taxes and service fees
currency: USD
amount: 24.77
- date: '2025-11-03T13:26:49.883Z'
net_amount:
currency: USD
amount: 0.0
credit_card_info:
last4_digits: '4448'
first6_digits: '444444'
card_type: Visa
breakdowns:
- type: Credit
currency: USD
amount: -233.94
- type: Cancel penalty
currency: USD
amount: 233.94
document_type: RECEIPT
central_bill: false
_links:
receipt_pdf:
href: https://apis.egencia.com/openconnect/api/v1/bookings/0000-3691-591/items/69091e07a314e1fa17f50214/receipts
booking_status: CANCELLED
check_in: '2025-11-05T16:00:00.001+01:00'
check_out: '2025-11-06T11:00:00.001+01:00'
location:
type: HOTEL
name: Van der Valk Hotel Berlin Brandenburg
address:
street_name: Eschenweg 18 Dahlewitz
country_code: DEU
city_name: Blankenfelde-Mahlow
state_province_name: Brandenburg Region
postal_code: '15827'
star_rating: '4.0'
provider: Expedia
property_id: '1401473778'
_links:
self:
href: https://apis.egencia.com/openconnect/api/v1/bookings/0000-3691-591/items/69091e07a314e1fa17f50214
trip:
href: https://www.egencia.com/trip-webapp/0000-3691-591?auth_gpid=48548
receipt:
href: https://apis.egencia.com/openconnect/api/v1/bookings/0000-3691-591/items/69091e07a314e1fa17f50214/receipts
Expense message for a Hotel cancellation:
description: Expense message for a Hotel cancellation
value:
uuid: 6e6159cf-f948-4dc5-b3c9-01bd541390d9
expense_id: HL-4a1eba773a39225e36a1e74c630497a5558ebf98
expense_version: 3
point_of_sale:
country_code: US
company:
id: 64139
name: CaspianTestUSCompany
organization_parent_id: 6556964
travelers:
- id: 7805149
first_name: Test
last_name: User
email: test.user@example.com
preferred_language: en
custom_data_fields: []
booker:
id: 7805148
first_name: Test
last_name: Manager
email: test.manager@example.com
is_agent: false
partner:
name: xxx
price:
currency: USD
amount: 298.54
cost_to_customer: 298.54
breakdowns:
- type: TOTAL_BASE
currency: USD
amount: 253.0
breakdowns:
- type: Tue, 10/14
currency: USD
amount: 253.0
- type: Taxes & Fees
currency: USD
amount: 45.54
penalties:
- type: Cancellation penalty
currency: USD
amount: 298.54
egencia_item_id: 68e912600d6c13e9ca9141d7
egencia_trip_id: 0000-3664-886
egencia_trip_link: https://www.egencia.com/trip-webapp/0000-3664-886?auth_gpid=64139
approval_triggered: false
payment_method: CREDIT_CARD
credit_card:
last4_digits: '4242'
first6_digits: '424242'
expense_type: HOTEL
gds_reference: '7415153227111'
booking_reference: '21876142594'
custom_data_fields: []
rate_type:
name: EGENCIA
code: EGENCIA
rules_and_regulations:
details:
- Cancellation and Changes
-
- '- This reservation is non-refundable and cannot be modified.
'
-
policy_compliance:
is_compliant: true
booking_date_time: '2025-10-10T00:00:00.000Z'
cancellation_date_time: '2025-10-13T15:11:31.835Z'
booking_status: CANCELLED
check_in: '2025-10-14T16:00:00.001-07:00'
check_out: '2025-10-15T11:00:00.001-07:00'
location:
type: HOTEL
name: citizenM Seattle Pioneer Square
address:
street_name: 60 Yesler Way
country_code: USA
city_name: Seattle
state_province_name: WA
postal_code: '98104'
star_rating: '4.0'
_links:
self:
href: https://apis.egencia.com/openconnect/api/v1/bookings/0000-3664-886/items/68e912600d6c13e9ca9141d7
trip:
href: https://www.egencia.com/trip-webapp/0000-3664-886?auth_gpid=64139
Expense message for a Hotel exchange:
description: Expense message for a Hotel exchange
value:
uuid: d69c43c6-b1d9-4a8c-879a-1470439028d9
expense_id: HL-e780265b3b6ac94a0da6414a18a300988b88f16c
expense_version: 2
point_of_sale:
country_code: US
company:
id: 64139
name: CaspianTestUSCompany
organization_parent_id: 6556964
travelers:
- id: 7805149
first_name: Test
last_name: User
email: test.user@example.com
preferred_language: en
custom_data_fields:
- label: Employee Id
value: '2222'
booker:
id: 7805149
first_name: Test
last_name: User
email: test.user@example.com
is_agent: false
partner:
name: xxx
price:
currency: USD
amount: 503.91
cost_to_customer: 503.91
breakdowns:
- type: TOTAL_BASE
currency: USD
amount: 417.0
breakdowns:
- type: Thu, 10/16
currency: USD
amount: 417.0
- type: Taxes & Fees
currency: USD
amount: 86.91
egencia_item_id: 68ed175f0d6c13e9ca9162eb
egencia_trip_id: 0000-3667-238
egencia_trip_link: https://www.egencia.com/trip-webapp/0000-3667-238?auth_gpid=64139
approval_triggered: false
payment_method: CREDIT_CARD
credit_card:
last4_digits: '4242'
first6_digits: '424242'
expense_type: HOTEL
gds_reference: '7328328028323'
booking_reference: '21876200518'
custom_data_fields:
- label: Employee Id
value: '2222'
rate_type:
name: EXPEDIA
code: EXPEDIA
rules_and_regulations:
details:
- Cancellation and Changes
-
- '- This reservation is non-refundable and cannot be modified.
'
-
policy_compliance:
is_compliant: true
booking_date_time: '2025-10-13T00:00:00.000Z'
booking_status: BOOKED
check_in: '2025-10-16T16:00:00.001-07:00'
check_out: '2025-10-17T11:00:00.001-07:00'
location:
type: HOTEL
name: Renaissance Seattle Hotel
address:
street_name: 515 Madison Street
country_code: USA
city_name: Seattle
state_province_name: WA
postal_code: '98104'
star_rating: '4.0'
_links:
self:
href: https://apis.egencia.com/openconnect/api/v1/bookings/0000-3667-238/items/68ed175f0d6c13e9ca9162eb
trip:
href: https://www.egencia.com/trip-webapp/0000-3667-238?auth_gpid=64139
Expense message for a Train booking:
description: Expense message for a Train booking
value:
uuid: 9aadcaf6-5465-47b3-8672-955db4b54850
expense_id: TN-3efd218474e7a180f143ed8f201eac78f5670bd0
expense_version: 1
point_of_sale:
country_code: GB
policy_compliance:
is_compliant: true
company:
id: 41543
name: Test Auto Airfusion FR
organization_parent_id: 1234567890
travelers:
- id: 5328422
first_name: Test
is_guest: false
last_name: User
email: test.user@example.com
preferred_language: fr
booker:
email: test.user@example.com
first_name: Test
last_name: User
id: 5328421
is_agent: false
approval_triggered: false
price:
currency: GBP
amount: 5.2
cost_to_customer: 5.2
breakdowns: []
egencia_trip_id: 0300-2512-610
egencia_trip_link: https://www.egencia.eu/trip-webapp/0300-2512-610?auth_gpid=41543
booking_status: BOOKED
payment_method: ON_ACCOUNT
expense_type: TRAIN
vendor_reference: JR9C97C3
booking_reference: B-EGENCIA-VFC0007IW
receipt_provision_available: false
custom_data_fields:
- label: Main cost centre
value: CC1
- label: Secondary cost centre
value: CC2
booking_date_time: '2021-09-30T12:35:20.000Z'
origin_destinations:
- segments:
- departure:
location:
type: TRAIN_STATION
code: GBSBJ
name: Stourbridge Junction
address:
country_code: GB
city_name: Stourbridge Junction
date_time: '2019-12-28T06:57:00.000Z'
arrival:
location:
type: TRAIN_STATION
code: GBBMO
name: Birmingham Moor Street
address:
country_code: GB
city_name: Birmingham Moor Street
date_time: '2019-12-28T07:39:00.000Z'
operating_carrier:
code: LondonMidland
name: London Midland
number: LM2870
traveler_segment_info:
- ticket:
number: '33'
traveler_id: 123
rules_and_regulations:
details:
- If you cancel before Sun, 26 Jan 2020 04:29:00 GMT before your ticket is printed, an admin fee of 10.00 GBP will be deducted from your refund.
- If you cancel before Sun, 26 Jan 2020 04:29:00 GMT after your ticket is printed, an admin fee of up to 10.00 GBP per ticket per passenger will be deducted from your refund. If the ticket is less than 10.00 GBP, the maximum admin fee is the ticket price.
booking_class: Standard
status: BOOKED
_links:
self:
href: https://apis.egencia.eu/openconnect/api/v1/bookings/0300-2512-610/items/6450a5b869d5bd432ab9cca8
trip:
href: https://www.egencia.eu/trip-webapp/0300-2512-610?auth_gpid=41543
Expense message for a Train booking with invoice:
description: Expense message for a Train booking with invoice
value:
uuid: 4002c72a-4f46-40df-9abb-d4855d3fe297
expense_id: TN-d17d80c5a7470c7145ee63f1d63112968a405c1b
expense_version: 2
point_of_sale:
country_code: FR
company:
id: 58401
name: Test Train Paris
organization_parent_id: 6555707
travelers:
- id: 7780308
first_name: Test
is_guest: false
last_name: User
email: test.user@example.com
preferred_language: en
custom_data_fields:
- label: Main cost centre
value: CC1
booker:
id: 7780308
first_name: Test
last_name: Agent
email: test.agent@example.com
is_agent: true
price:
currency: EUR
amount: 25.0
cost_to_customer: 25.0
breakdowns: []
egencia_item_id: 690068673cfe3643146bbe0c
egencia_trip_id: 2000-3184-206
egencia_trip_link: https://www.egencia.eu/trip-webapp/2000-3184-206?auth_gpid=58401
approval_triggered: false
payment_method: ON_ACCOUNT
expense_type: TRAIN
vendor_reference: 9AEX65
booking_reference: 9AEX65
custom_data_fields:
- label: Main cost centre
value: CC1
policy_compliance:
is_compliant: true
booking_date_time: '2025-10-27T00:00:00.000Z'
receipt_provision_available: true
receipt_info:
id: FRI9157764
status: AVAILABLE
receipt_date: '2025-10-30'
total_amount:
currency: EUR
amount: 37.0
payments:
- date: '2025-10-30'
net_amount:
currency: EUR
amount: 25.0
credit_card_info:
last4_digits: '4444'
first6_digits: '555555'
card_type: MASTER_CARD
breakdowns:
- type: BASE
currency: EUR
amount: 25.0
- type: TAX
currency: EUR
amount: 0.0
line_type: PRODUCT
- date: '2025-10-30'
net_amount:
currency: EUR
amount: 12.0
credit_card_info:
last4_digits: '4444'
first6_digits: '555555'
card_type: MASTER_CARD
breakdowns:
- type: BASE
currency: EUR
amount: 12.0
- type: TAX
currency: EUR
amount: 0.0
line_type: EGENCIA_FEE
document_type: INVOICE
central_bill: false
_links:
receipt_pdf:
href: https://apis.egencia.eu/openconnect/api/v2/bookings/2000-3184-206/items/690068673cfe3643146bbe0c/receipts/FRI9157764?traveler_id=7780308
booking_status: BOOKED
origin_destinations:
- segments:
- provider:
code: OUIGO
name: Ouigo Grande Vitesse
rules_and_regulations:
details:
- EU_PASSENGER_RIGHTS_REGULATION
- Offre Essentiel Adulte
- All changes are applied per trip and per passenger.
- Billet non annulable, non remboursable. Échangeable ou modifiable en ligne jusqu'à 30 min avant le départ de votre train, sous conditions avec frais d'échange de maximum 19€ par trajet et par voyageur (les frais d’échange ne s’appliquent pas avec l’option OuigoFlex).
- Boarding is open 30 minutes before the train's departure, and access to the train is denied 5 minutes before departure.
- In addition to these fees, there may be a price difference between your old and new tickets. If this difference is negative, it will not be reimbursed.
- L'embarquement est ouvert 30 minutes avant le départ du train et l'accès au train est refusé 5 minutes avant le départ.
- Le billet est disponible à partir de 4 jours avant le départ du train.
- Non-cancellable, non-refundable ticket. You can exchange or modify your ticket online up to 30 minutes before the departure of your train, subject to conditions and an exchange fee of no more than €19 per journey and per passenger (exchange fees do not apply to the OuigoFlex option).
- Proof of ID must be shown.
- Présentation d'un justificatif d'identité obligatoire.
- S'ajoute à ces frais, l'éventuelle différence tarifaire entre l'ancien et le nouveau billet. Si la différence tarifaire est négative, celle-ci n’est pas remboursée.
- The ticket is available starting from 4 days before the train's departure.
- Toute modification s'applique par trajet et à l'ensemble des voyageurs.
status: BOOKED
booking_class: OUIGO ESSENTIEL
departure:
location:
type: TRAIN_STATION
code: FRXYD
name: Lyon Part Dieu
address:
country_code: FR
city_name: Lyon Part Dieu
date_time: '2025-12-30T08:38:00.000+01:00'
arrival:
location:
type: TRAIN_STATION
code: FRLYS
name: Paris Gare De Lyon
address:
country_code: FR
city_name: Paris Gare De Lyon
date_time: '2025-12-30T10:34:00.000+01:00'
operating_carrier:
name: Ouigo Grande Vitesse
code: OUIGO
number: '7802'
marketing_carrier:
name: Ouigo Grande Vitesse
code: OUIGO
number: '7802'
traveler_segment_info:
- traveler_id: 7780308
_links:
self:
href: https://apis.egencia.eu/openconnect/api/v1/bookings/2000-3184-206/items/690068673cfe3643146bbe0c
trip:
href: https://www.egencia.eu/trip-webapp/2000-3184-206?auth_gpid=58401
receipt:
href: https://apis.egencia.eu/openconnect/api/v1/bookings/2000-3184-206/items/690068673cfe3643146bbe0c/receipts
Expense message for a Train cancellation (One Way Agency):
description: Expense message for a Train cancellation (One Way Agency)
value:
uuid: 6c1633a2-16ef-47b3-a602-90d698b29e5a
expense_id: TN-eeb99a681fd6cf3522f6c1250c8d66a8dd4140ab
expense_version: 2
point_of_sale:
country_code: US
company:
id: 64139
name: CaspianTestUSCompany
organization_parent_id: 6556964
travelers:
- id: 7805149
first_name: Test
last_name: User
email: test.user@example.com
preferred_language: en
custom_data_fields: []
booker:
id: 7805149
first_name: Test
last_name: User
email: test.user@example.com
is_agent: false
partner:
name: xxx
price:
currency: USD
amount: 0.0
cost_to_customer: 0.0
breakdowns: []
egencia_item_id: 68f10c944b169cd84f9323f4
egencia_trip_id: 0000-3673-892
egencia_trip_link: https://www.egencia.com/trip-webapp/0000-3673-892?auth_gpid=64139
approval_triggered: false
payment_method: CREDIT_CARD
credit_card:
last4_digits: '4448'
first6_digits: '444444'
expense_type: TRAIN
vendor_reference: C6353A
booking_reference: '21876301431'
custom_data_fields: []
policy_compliance:
is_compliant: true
booking_date_time: '2025-10-16T00:00:00.000Z'
cancellation_date_time: '2025-10-16T15:18:22.821Z'
booking_status: CANCELLED
origin_destinations:
- segments:
- provider:
code: Amtrak
name: Amtrak
rules_and_regulations:
details:
- Flex
- '
Cancellations: no fee, 100% returned to original form of payment.
Changes: no fee, difference in fare may apply.
'
status: CANCELLED
booking_class: COACH SEAT
departure:
location:
type: TRAIN_STATION
code: USSAC
name: Sacramento, CA
address:
country_code: US
city_name: Sacramento, CA
date_time: '2025-10-19T06:48:00.000-07:00'
arrival:
location:
type: TRAIN_STATION
code: USLAX
name: Los Angeles, CA
address:
country_code: US
city_name: Los Angeles, CA
date_time: '2025-10-19T21:11:00.000-07:00'
operating_carrier:
name: Amtrak
code: Amtrak
number: '11'
marketing_carrier:
name: Amtrak
code: Amtrak
number: '11'
traveler_segment_info:
- traveler_id: 7805149
- provider:
code: Amtrak
name: Amtrak
rules_and_regulations:
details:
- Flex
- '
Cancellations: no fee, 100% returned to original form of payment.
Changes: no fee, difference in fare may apply.
'
status: CANCELLED
booking_class: COACH SEAT
departure:
location:
type: TRAIN_STATION
code: USLAX
name: Los Angeles, CA
address:
country_code: US
city_name: Los Angeles, CA
date_time: '2025-10-19T22:00:00.000-07:00'
arrival:
location:
type: TRAIN_STATION
code: USMRC
name: Maricopa, AZ
address:
country_code: US
city_name: Maricopa, AZ
date_time: '2025-10-20T05:35:00.000-07:00'
operating_carrier:
name: Amtrak
code: Amtrak
number: '2'
marketing_carrier:
name: Amtrak
code: Amtrak
number: '2'
traveler_segment_info:
- traveler_id: 7805149
- provider:
code: Amtrak
name: Amtrak
rules_and_regulations:
details:
- Flex
- '
Cancellations: no fee, 100% returned to original form of payment.
Changes: no fee, difference in fare may apply.
'
status: CANCELLED
booking_class: AMTRAK CONNECTION SEAT
departure:
location:
type: TRAIN_STATION
code: USMRC
name: Maricopa, AZ
address:
country_code: US
city_name: Maricopa, AZ
date_time: '2025-10-20T05:45:00.000-07:00'
arrival:
location:
type: TRAIN_STATION
code: USPXN
name: Phoenix (North), AZ
address:
country_code: US
city_name: Phoenix (North), AZ
date_time: '2025-10-20T07:15:00.000-07:00'
operating_carrier:
name: Amtrak
code: Amtrak
number: '8902'
marketing_carrier:
name: Amtrak
code: Amtrak
number: '8902'
traveler_segment_info:
- traveler_id: 7805149
_links:
self:
href: https://apis.egencia.com/openconnect/api/v1/bookings/0000-3673-892/items/68f10c944b169cd84f9323f4
trip:
href: https://www.egencia.com/trip-webapp/0000-3673-892?auth_gpid=64139
schema:
type: string
description: Successful operations
'400':
description: Bad request.
'429':
description: 'Too many requests: will be retried 3 times automatically on our side.'
'502':
description: 'Bad gateway: will be retried 3 times automatically on our side.'
'503':
description: 'Service unavailable: will be retried 3 times automatically on our side.'
'504':
description: 'Gateway timeout: will be retried 3 times automatically on our side.'
summary: Push Expense
tags:
- Expense SPI
/some.base.path/v1/subscriptions:
post:
description: The SPI handles all the standard HTTP return codes. The 'Responses' chapter shows the codes that will trigger an automatic retry mechanism on our side in order to enhance the success of the delivery. For any other error or when the maximum retries has been reached, it will need a manual intervention and we might contact your technical service if the issue comes from your server.
operationId: pushSubscriptionNotification
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SubscriptionEvent'
required: true
responses:
'200':
content:
application/json:
schema:
type: string
description: Successful operations
'400':
description: Bad request.
'429':
description: 'Too many requests: will be retried 3 times automatically on our side.'
'502':
description: 'Bad gateway: will be retried 3 times automatically on our side.'
'503':
description: 'Service unavailable: will be retried 3 times automatically on our side.'
'504':
description: 'Gateway timeout: will be retried 3 times automatically on our side.'
summary: Push Subscription Events
tags:
- Expense SPI
components:
schemas:
RulesAndRegulations:
properties:
details:
type: array
description: Raw text describing provider rules and regulations.
example: Can be modified with a penalty..
items:
type: string
description: Raw text describing provider rules and regulations.
example: Can be modified with a penalty..
title: RulesAndRegulations
Address:
description: Address details of the location
properties:
city_code:
type: string
description: City code.
city_name:
type: string
description: Name of the city.
country_code:
type: string
description: Country code.
country_name:
type: string
description: Name of the country.
postal_code:
type: string
description: Postal code of the location.
state_province_code:
type: string
description: State province code.
state_province_name:
type: string
description: Name of the state province.
street_name:
type: string
description: Name of the street.
title: Address
GroundTransferType:
description: Describes the ground transfer type
example: Describes the ground transfer type
properties:
code:
type: string
description: Code of the transfer vehicle
example: AIRPORT_BUS
description:
type: string
description: Description of the transfer vehicle
example: Express Bus from/to Airport
required:
- code
- description
title: GroundTransferType
Subscription:
description: Subscription details
properties:
subscribed:
type: array
description: List of subscribed entities
items:
$ref: '#/components/schemas/SubscriptionEntity'
type:
type: string
description: Type of suscribed or unsubscribed entity
enum:
- COMPANY
unsubscribed:
type: array
description: List of unsubscribed entities
items:
$ref: '#/components/schemas/SubscriptionEntity'
title: Subscription
Fee:
properties:
approval_deadline:
type: string
description: Only when approval is enabled, time limit to approve/reject an item
example: '2021-04-15T15:26:00.000Z'
approval_status:
type: string
description: Only when approval is enabled.
enum:
- PENDING
- APPROVED
- DENIED
- CANCELLED
example: APPROVED
approval_triggered:
type: boolean
description: Flag to indicate whether approval got triggered for the transaction or not.
associated_booking_reference:
type: string
description: Booking reference indicating the booking with which Fee is associated
example: '48523737071'
booker:
$ref: '#/components/schemas/Person'
booking_date_time:
type: string
description: The date and time the booking occurred on an itinerary.
booking_reference:
type: string
description: This is the reference of the Train, Flight, Hotel or Car booking as you can see it in your Egencia Trip Summary.
example: AZ23D
booking_status:
type: string
enum:
- BOOKED
- CANCELLED
- DRAFT
- DELETED
- AWAITING_CONFIRMATION
cancellation_date_time:
type: string
description: The date and time the booking was last cancelled.
company:
$ref: '#/components/schemas/Company'
credit_card:
$ref: '#/components/schemas/CreditCardInfo'
custom_data_fields:
type: array
deprecated: true
description: List of custom data fields. Can be company's cost centers for example.
items:
$ref: '#/components/schemas/CustomDataField'
egencia_item_id:
type: string
description: Unique identifier for the expense item in Egencia.
egencia_trip_id:
type: string
description: This Identifier is mutable and represents the Trip concept. In Egencia, Trip is the container that regroups the transactions, and this is what the user will see. It can be used to consolidate the bookings together like in Egencia.
example: 8006-8583-907
egencia_trip_link:
type: string
description: Link to trip in Egencia. SSO/Login vanity URL if the company is enabled.
expense_id:
type: string
description: Expense Transaction immutable and unique identifier for the product or service bought.
example: HL-a9fbb6cc6127cda4a4db8846dd1a9a3a6da7fd0b
expense_type:
type: string
description: Type of product.
enum:
- FLIGHT
- GROUND
- HOTEL
- TRAIN
- FEE
- CAR
expense_version:
type: integer
format: int32
description: The version of an Expense. It changes whenever a bought product has been updated.
example: 3
gds_reference:
type: string
description: External GDS (global distribution systems) reference. PNR (passenger name record) for flight.
example: ZJSZVT
label:
type: string
description: Fee's description.
example: Agent assisted air purchase fee
links:
type: array
items:
$ref: '#/components/schemas/Link'
mission_number:
type: string
description: Partner mission order number
partner:
$ref: '#/components/schemas/Partner'
payment_method:
type: string
description: The payment mean used for the booking.
enum:
- COMPANY_FORM_OF_PAYMENT
- CREDIT_CARD
- LODGED_CARD
- ON_ACCOUNT
- VIAPAY
- PAY_AT_COUNTER
- DIRECT_BILLING
- ACCREDITIVE
- ACCREDITIVE_CARD
- COMPANY_CARD
- PREPAID_BY_ECT
point_of_sale:
$ref: '#/components/schemas/PointOfSale'
policy_compliance:
$ref: '#/components/schemas/PolicyCompliance'
price:
$ref: '#/components/schemas/Price'
rate_type:
$ref: '#/components/schemas/RateType'
receipt_info:
$ref: '#/components/schemas/ReceiptInfo'
receipt_provision_available:
type: boolean
description: Indicates if receipt is generated by Egencia for this expense item.
rules_and_regulations:
$ref: '#/components/schemas/RulesAndRegulations'
travelers:
type: array
description: The travelers who are part of this reservation.
items:
$ref: '#/components/schemas/Person'
uuid:
type: string
format: uuid
vendor_reference:
type: string
description: Product vendor reference
example: 366L3FN9E
required:
- company
- custom_data_fields
- egencia_item_id
- egencia_trip_id
- egencia_trip_link
- expense_id
- expense_type
- label
- uuid
title: Fee
Link:
properties:
deprecation:
type: string
href:
type: string
hreflang:
type: string
media:
type: string
name:
type: string
profile:
type: string
rel:
type: string
title:
type: string
type:
type: string
Fare:
description: Details about fare.
properties:
amount:
type: number
format: double
description: Amount
currency:
type: string
description: Currency
CO2Emission:
description: The details of the Carbon dioxide (CO2) emission.
properties:
equivalencies:
type: array
description: The CO2 emission equivalencies information.
items:
$ref: '#/components/schemas/CO2EmissionEquivalency'
offset_amount:
type: number
description: The CO2 emission offset amount.
offset_currency:
type: string
description: The CO2 emission offset currency.
unit:
type: string
description: The unit of the CO2 emission.
enum:
- KG
- LB
example: KG, LB
value:
type: integer
format: int32
description: The value of the CO2 emission.
title: CO2Emission
GlobalGround:
properties:
approval_deadline:
type: string
description: Only when approval is enabled, time limit to approve/reject an item
example: '2021-04-15T15:26:00.000Z'
approval_status:
type: string
description: Only when approval is enabled.
enum:
- PENDING
- APPROVED
- DENIED
- CANCELLED
example: APPROVED
approval_triggered:
type: boolean
description: Flag to indicate whether approval got triggered for the transaction or not.
booker:
$ref: '#/components/schemas/Person'
booking_date_time:
type: string
description: The date and time the booking occurred on an itinerary.
booking_reference:
type: string
description: This is the reference of the Train, Flight, Hotel or Car booking as you can see it in your Egencia Trip Summary.
example: AZ23D
booking_status:
type: string
enum:
- BOOKED
- CANCELLED
- DRAFT
- DELETED
- AWAITING_CONFIRMATION
cancellation_date_time:
type: string
description: The date and time the booking was last cancelled.
company:
$ref: '#/components/schemas/Company'
credit_card:
$ref: '#/components/schemas/CreditCardInfo'
custom_data_fields:
type: array
deprecated: true
description: List of custom data fields. Can be company's cost centers for example.
items:
$ref: '#/components/schemas/CustomDataField'
drop_off:
$ref: '#/components/schemas/SegmentStep'
egencia_item_id:
type: string
description: Unique identifier for the expense item in Egencia.
egencia_trip_id:
type: string
description: This Identifier is mutable and represents the Trip concept. In Egencia, Trip is the container that regroups the transactions, and this is what the user will see. It can be used to consolidate the bookings together like in Egencia.
example: 8006-8583-907
egencia_trip_link:
type: string
description: Link to trip in Egencia. SSO/Login vanity URL if the company is enabled.
expense_id:
type: string
description: Expense Transaction immutable and unique identifier for the product or service bought.
example: HL-a9fbb6cc6127cda4a4db8846dd1a9a3a6da7fd0b
expense_type:
type: string
description: Type of product.
enum:
- FLIGHT
- GROUND
- HOTEL
- TRAIN
- FEE
- CAR
expense_version:
type: integer
format: int32
description: The version of an Expense. It changes whenever a bought product has been updated.
example: 3
gds_reference:
type: string
description: External GDS (global distribution systems) reference. PNR (passenger name record) for flight.
example: ZJSZVT
ground_transfer_type:
$ref: '#/components/schemas/GroundTransferType'
links:
type: array
items:
$ref: '#/components/schemas/Link'
mission_number:
type: string
description: Partner mission order number
partner:
$ref: '#/components/schemas/Partner'
payment_method:
type: string
description: The payment mean used for the booking.
enum:
- COMPANY_FORM_OF_PAYMENT
- CREDIT_CARD
- LODGED_CARD
- ON_ACCOUNT
- VIAPAY
- PAY_AT_COUNTER
- DIRECT_BILLING
- ACCREDITIVE
- ACCREDITIVE_CARD
- COMPANY_CARD
- PREPAID_BY_ECT
pick_up:
$ref: '#/components/schemas/SegmentStep'
point_of_sale:
$ref: '#/components/schemas/PointOfSale'
policy_compliance:
$ref: '#/components/schemas/PolicyCompliance'
price:
$ref: '#/components/schemas/Price'
rate_type:
$ref: '#/components/schemas/RateType'
receipt_info:
$ref: '#/components/schemas/ReceiptInfo'
receipt_provision_available:
type: boolean
description: Indicates if receipt is generated by Egencia for this expense item.
rules_and_regulations:
$ref: '#/components/schemas/RulesAndRegulations'
travelers:
type: array
description: The travelers who are part of this reservation.
items:
$ref: '#/components/schemas/Person'
uuid:
type: string
format: uuid
vehicle:
$ref: '#/components/schemas/GroundVehicle'
vendor:
$ref: '#/components/schemas/Provider'
vendor_reference:
type: string
description: Product vendor reference
example: 366L3FN9E
required:
- company
- custom_data_fields
- drop_off
- egencia_item_id
- egencia_trip_id
- egencia_trip_link
- expense_id
- expense_type
- ground_transfer_type
- pick_up
- uuid
- vendor
title: Ground
PolicyCompliance:
description: Policy compliance details
properties:
is_compliant:
type: boolean
description: Flag indicating whether the item is compliant or not.
reasons:
type: array
description: Reasons describing why the item is not policy compliant.
items:
$ref: '#/components/schemas/ViolationReason'
title: PolicyCompliance
RateType:
properties:
code:
type: string
description: CORPORATE
name:
type: string
description: Corporate rate
required:
- code
- name
title: RateType
Train:
properties:
approval_deadline:
type: string
description: Only when approval is enabled, time limit to approve/reject an item
example: '2021-04-15T15:26:00.000Z'
approval_status:
type: string
description: Only when approval is enabled.
enum:
- PENDING
- APPROVED
- DENIED
- CANCELLED
example: APPROVED
approval_triggered:
type: boolean
description: Flag to indicate whether approval got triggered for the transaction or not.
booker:
$ref: '#/components/schemas/Person'
booking_date_time:
type: string
description: The date and time the booking occurred on an itinerary.
booking_reference:
type: string
description: This is the reference of the Train, Flight, Hotel or Car booking as you can see it in your Egencia Trip Summary.
example: AZ23D
booking_status:
type: string
enum:
- BOOKED
- CANCELLED
- DRAFT
- DELETED
- AWAITING_CONFIRMATION
cancellation_date_time:
type: string
description: The date and time the booking was last cancelled.
company:
$ref: '#/components/schemas/Company'
credit_card:
$ref: '#/components/schemas/CreditCardInfo'
custom_data_fields:
type: array
deprecated: true
description: List of custom data fields. Can be company's cost centers for example.
items:
$ref: '#/components/schemas/CustomDataField'
egencia_item_id:
type: string
description: Unique identifier for the expense item in Egencia.
egencia_trip_id:
type: string
description: This Identifier is mutable and represents the Trip concept. In Egencia, Trip is the container that regroups the transactions, and this is what the user will see. It can be used to consolidate the bookings together like in Egencia.
example: 8006-8583-907
egencia_trip_link:
type: string
description: Link to trip in Egencia. SSO/Login vanity URL if the company is enabled.
expense_id:
type: string
description: Expense Transaction immutable and unique identifier for the product or service bought.
example: HL-a9fbb6cc6127cda4a4db8846dd1a9a3a6da7fd0b
expense_type:
type: string
description: Type of product.
enum:
- FLIGHT
- GROUND
- HOTEL
- TRAIN
- FEE
- CAR
expense_version:
type: integer
format: int32
description: The version of an Expense. It changes whenever a bought product has been updated.
example: 3
gds_reference:
type: string
description: External GDS (global distribution systems) reference. PNR (passenger name record) for flight.
example: ZJSZVT
links:
type: array
items:
$ref: '#/components/schemas/Link'
mission_number:
type: string
description: Partner mission order number
origin_destinations:
type: array
description: List of origins to destinations. For example a round trip would have 2 origin destination in this list (e.g. Paris -> Tokyo, Tokyo -> Paris).
items:
$ref: '#/components/schemas/FlightOriginDestination'
minItems: 1
partner:
$ref: '#/components/schemas/Partner'
payment_method:
type: string
description: The payment mean used for the booking.
enum:
- COMPANY_FORM_OF_PAYMENT
- CREDIT_CARD
- LODGED_CARD
- ON_ACCOUNT
- VIAPAY
- PAY_AT_COUNTER
- DIRECT_BILLING
- ACCREDITIVE
- ACCREDITIVE_CARD
- COMPANY_CARD
- PREPAID_BY_ECT
point_of_sale:
$ref: '#/components/schemas/PointOfSale'
policy_compliance:
$ref: '#/components/schemas/PolicyCompliance'
price:
$ref: '#/components/schemas/Price'
rate_type:
$ref: '#/components/schemas/RateType'
receipt_info:
$ref: '#/components/schemas/ReceiptInfo'
receipt_provision_available:
type: boolean
description: Indicates if receipt is generated by Egencia for this expense item.
rules_and_regulations:
$ref: '#/components/schemas/RulesAndRegulations'
ticket_number:
type: array
description: Ticket number. Only when booking is issued.
example: 0067508252738
items:
type: string
description: Ticket number. Only when booking is issued.
example: 0067508252738
travelers:
type: array
description: The travelers who are part of this reservation.
items:
$ref: '#/components/schemas/Person'
uuid:
type: string
format: uuid
vendor_reference:
type: string
description: Product vendor reference
example: 366L3FN9E
required:
- company
- custom_data_fields
- egencia_item_id
- egencia_trip_id
- egencia_trip_link
- expense_id
- expense_type
- origin_destinations
- uuid
title: Train
PointOfSale:
description: A point of sale is defined by the intersection of a company, a management unit, and a jurisdiction.
properties:
country_code:
type: string
description: ISO 3166-1 alpha-2 country code.
example: FR
required:
- country_code
title: PointOfSale
Flight:
properties:
approval_deadline:
type: string
description: Only when approval is enabled, time limit to approve/reject an item
example: '2021-04-15T15:26:00.000Z'
approval_status:
type: string
description: Only when approval is enabled.
enum:
- PENDING
- APPROVED
- DENIED
- CANCELLED
example: APPROVED
approval_triggered:
type: boolean
description: Flag to indicate whether approval got triggered for the transaction or not.
booker:
$ref: '#/components/schemas/Person'
booking_date_time:
type: string
description: The date and time the booking occurred on an itinerary.
booking_reference:
type: string
description: This is the reference of the Train, Flight, Hotel or Car booking as you can see it in your Egencia Trip Summary.
example: AZ23D
booking_status:
type: string
enum:
- BOOKED
- CANCELLED
- DRAFT
- DELETED
- AWAITING_CONFIRMATION
cancellation_date_time:
type: string
description: The date and time the booking was last cancelled.
company:
$ref: '#/components/schemas/Company'
credit_card:
$ref: '#/components/schemas/CreditCardInfo'
custom_data_fields:
type: array
deprecated: true
description: List of custom data fields. Can be company's cost centers for example.
items:
$ref: '#/components/schemas/CustomDataField'
egencia_item_id:
type: string
description: Unique identifier for the expense item in Egencia.
egencia_trip_id:
type: string
description: This Identifier is mutable and represents the Trip concept. In Egencia, Trip is the container that regroups the transactions, and this is what the user will see. It can be used to consolidate the bookings together like in Egencia.
example: 8006-8583-907
egencia_trip_link:
type: string
description: Link to trip in Egencia. SSO/Login vanity URL if the company is enabled.
expense_id:
type: string
description: Expense Transaction immutable and unique identifier for the product or service bought.
example: HL-a9fbb6cc6127cda4a4db8846dd1a9a3a6da7fd0b
expense_type:
type: string
description: Type of product.
enum:
- FLIGHT
- GROUND
- HOTEL
- TRAIN
- FEE
- CAR
expense_version:
type: integer
format: int32
description: The version of an Expense. It changes whenever a bought product has been updated.
example: 3
gds_reference:
type: string
description: External GDS (global distribution systems) reference. PNR (passenger name record) for flight.
example: ZJSZVT
links:
type: array
items:
$ref: '#/components/schemas/Link'
mission_number:
type: string
description: Partner mission order number
origin_destinations:
type: array
description: List of origins to destinations. For example a round trip would have 2 origin destination in this list (e.g. Paris -> Tokyo, Tokyo -> Paris).
items:
$ref: '#/components/schemas/FlightOriginDestination'
minItems: 1
partner:
$ref: '#/components/schemas/Partner'
payment_method:
type: string
description: The payment mean used for the booking.
enum:
- COMPANY_FORM_OF_PAYMENT
- CREDIT_CARD
- LODGED_CARD
- ON_ACCOUNT
- VIAPAY
- PAY_AT_COUNTER
- DIRECT_BILLING
- ACCREDITIVE
- ACCREDITIVE_CARD
- COMPANY_CARD
- PREPAID_BY_ECT
point_of_sale:
$ref: '#/components/schemas/PointOfSale'
policy_compliance:
$ref: '#/components/schemas/PolicyCompliance'
price:
$ref: '#/components/schemas/Price'
rate_type:
$ref: '#/components/schemas/RateType'
receipt_info:
$ref: '#/components/schemas/ReceiptInfo'
receipt_provision_available:
type: boolean
description: Indicates if receipt is generated by Egencia for this expense item.
rules_and_regulations:
$ref: '#/components/schemas/RulesAndRegulations'
ticket_number:
type: array
description: Ticket number. Only when booking is issued.
example: 0067508252738
items:
type: string
description: Ticket number. Only when booking is issued.
example: 0067508252738
travelers:
type: array
description: The travelers who are part of this reservation.
items:
$ref: '#/components/schemas/Person'
uuid:
type: string
format: uuid
vendor_reference:
type: string
description: Product vendor reference
example: 366L3FN9E
required:
- company
- custom_data_fields
- egencia_item_id
- egencia_trip_id
- egencia_trip_link
- expense_id
- expense_type
- origin_destinations
- uuid
title: Flight
Company:
description: Traveler's company name and id.
properties:
id:
type: integer
format: int64
name:
type: string
organization_parent_id:
type: integer
format: int64
description: Organization Id of the company. It is the same as the company Id when no organization is defined
example: 6555689
partner_customer_code:
type: string
description: The partner_customer_code is the unique identifier of a client in the application of the partner. For partners who request it, partner_customer_code must be set everytime a customer subscribes to those partners.
example: JE3B
required:
- id
- name
title: Company
SegmentStep:
description: Describes the location/date of destination
properties:
date_time:
type: string
description: ISO 8601 date and time.
example: '2020-04-06T10:20:00.000-05:00'
location:
$ref: '#/components/schemas/Location'
required:
- date_time
- location
title: SegmentStep
Person:
description: Details of the person
properties:
custom_data_fields:
type: array
description: Custom data fields associated with the traveler
items:
$ref: '#/components/schemas/CustomDataField'
email:
type: string
description: Email of the person
first_name:
type: string
description: First name of the person
id:
type: integer
format: int64
description: Person id
is_agent:
type: boolean
description: Flag indicating whether the person is agent or not
is_guest:
type: boolean
description: Flag indicating whether the person is guest traveler or not
last_name:
type: string
description: Last name of the person
preferred_language:
type: string
description: The preferred language of the person
required:
- email
- first_name
- last_name
title: Person
Expense:
discriminator:
propertyName: expenseType
oneOf:
- $ref: '#/components/schemas/Car'
- $ref: '#/components/schemas/Fee'
- $ref: '#/components/schemas/Flight'
- $ref: '#/components/schemas/Hotel'
- $ref: '#/components/schemas/Train'
- $ref: '#/components/schemas/GlobalGround'
properties:
approval_deadline:
type: string
description: Only when approval is enabled, time limit to approve/reject an item
example: '2021-04-15T15:26:00.000Z'
approval_status:
type: string
description: Only when approval is enabled.
enum:
- PENDING
- APPROVED
- DENIED
- CANCELLED
example: APPROVED
approval_triggered:
type: boolean
description: Flag to indicate whether approval got triggered for the transaction or not.
booker:
$ref: '#/components/schemas/Person'
booking_date_time:
type: string
description: The date and time the booking occurred on an itinerary.
booking_reference:
type: string
description: This is the reference of the Train, Flight, Hotel or Car booking as you can see it in your Egencia Trip Summary.
example: AZ23D
cancellation_date_time:
type: string
description: The date and time the booking was last cancelled.
company:
$ref: '#/components/schemas/Company'
credit_card:
$ref: '#/components/schemas/CreditCardInfo'
custom_data_fields:
type: array
deprecated: true
description: List of custom data fields. Can be company's cost centers for example.
items:
$ref: '#/components/schemas/CustomDataField'
egencia_item_id:
type: string
description: Unique identifier for the expense item in Egencia.
egencia_trip_id:
type: string
description: This Identifier is mutable and represents the Trip concept. In Egencia, Trip is the container that regroups the transactions, and this is what the user will see. It can be used to consolidate the bookings together like in Egencia.
example: 8006-8583-907
egencia_trip_link:
type: string
description: Link to trip in Egencia. SSO/Login vanity URL if the company is enabled.
expense_id:
type: string
description: Expense Transaction immutable and unique identifier for the product or service bought.
example: HL-a9fbb6cc6127cda4a4db8846dd1a9a3a6da7fd0b
expense_type:
type: string
description: Type of product.
enum:
- FLIGHT
- GROUND
- HOTEL
- TRAIN
- FEE
- CAR
expense_version:
type: integer
format: int32
description: The version of an Expense. It changes whenever a bought product has been updated.
example: 3
gds_reference:
type: string
description: External GDS (global distribution systems) reference. PNR (passenger name record) for flight.
example: ZJSZVT
links:
type: array
items:
$ref: '#/components/schemas/Link'
mission_number:
type: string
description: Partner mission order number
partner:
$ref: '#/components/schemas/Partner'
payment_method:
type: string
description: The payment mean used for the booking.
enum:
- COMPANY_FORM_OF_PAYMENT
- CREDIT_CARD
- LODGED_CARD
- ON_ACCOUNT
- VIAPAY
- PAY_AT_COUNTER
- DIRECT_BILLING
- ACCREDITIVE
- ACCREDITIVE_CARD
- COMPANY_CARD
- PREPAID_BY_ECT
point_of_sale:
$ref: '#/components/schemas/PointOfSale'
policy_compliance:
$ref: '#/components/schemas/PolicyCompliance'
price:
$ref: '#/components/schemas/Price'
rate_type:
$ref: '#/components/schemas/RateType'
receipt_provision_available:
type: boolean
description: Indicates if receipt is generated by Egencia for this expense item.
rules_and_regulations:
$ref: '#/components/schemas/RulesAndRegulations'
travelers:
type: array
description: The travelers who are part of this reservation.
items:
$ref: '#/components/schemas/Person'
uuid:
type: string
format: uuid
vendor_reference:
type: string
description: Product vendor reference
example: 366L3FN9E
required:
- company
- custom_data_fields
- egencia_item_id
- egencia_trip_id
- egencia_trip_link
- expense_id
- expense_type
- uuid
title: Expense
Location:
description: Hotel's address
properties:
address:
$ref: '#/components/schemas/Address'
code:
type: string
description: Airport IATA code or any station code. Mandatory for AIRPORT type only.
example: CDG
name:
type: string
description: Name of airport, station, city or hotel. Mandatory for all types except ADDRESS.
example: Stockholm Arlanda
type:
type: string
description: The type of location.
enum:
- AIRPORT
- CITY
- TRAIN_STATION
- ADDRESS
- HOTEL
required:
- address
- type
title: Location
CustomDataField:
description: Billing data added during the booking process.
properties:
label:
type: string
value:
type: string
required:
- label
title: CustomDataField
Segment:
description: Segment is part of an origin to destination.
properties:
arrival:
$ref: '#/components/schemas/SegmentStep'
booking_class:
type: string
description: The booking class code.
example: FIRST
co2_emission:
$ref: '#/components/schemas/CO2Emission'
departure:
$ref: '#/components/schemas/SegmentStep'
marketing_carrier:
$ref: '#/components/schemas/Carrier'
operating_carrier:
$ref: '#/components/schemas/Carrier'
provider:
$ref: '#/components/schemas/Provider'
rate_type:
$ref: '#/components/schemas/RateType'
rules_and_regulations:
$ref: '#/components/schemas/RulesAndRegulations'
status:
type: string
description: Status of a segment as it can be different from main bookingStatus.
enum:
- BOOKED
- CANCELLED
- DRAFT
- DELETED
- AWAITING_CONFIRMATION
traveler_segment_info:
type: array
description: The segment-specific information pertaining to the traveler.
items:
$ref: '#/components/schemas/TravelerSegmentInfo'
required:
- arrival
- booking_class
- departure
title: Segment
ViolationReason:
description: Policy non-compliance reasons
properties:
best_fare:
$ref: '#/components/schemas/Fare'
message:
type: string
description: Message explanation of non-compliance reason.
type:
type: string
description: Type of the reason.
title: ViolationReason
ReceiptInfo:
description: Details about receipt like id, date, version etc. 'receipt_info' appears whenever a payment receipt or an invoice has been generated for the booking.
properties:
central_bill:
type: boolean
document_type:
type: string
description: Type of document, it can be INVOICE or CREDIT or RECEIPT
id:
type: string
description: The 'id' is the reference of the last receipt or invoice or credit note generated for that booking as it appears in the PDF document. If multiple payments are required for a booking or if refunds occur, then multiple invoices and credit notes will be available to download, and the 'id' will be the one of the last document generated. Also keep in mind that Expense SPI sends a message every time an invoice or credit note is created, so by keeping track of the 'id' element you'll have a perfect visibility of the order in which those documents have been issued.
links:
type: array
items:
$ref: '#/components/schemas/Link'
payments:
type: array
description: Payments.
items:
$ref: '#/components/schemas/Payment'
receipt_date:
type: string
description: Receipt date
receipt_number:
type: string
description: Receipt number
status:
type: string
description: Status of the receipt.
total_amount:
$ref: '#/components/schemas/Fare'
traveler_id:
type: integer
format: int64
description: Id of the traveler to whom invoice/receipt is issued
version:
type: integer
format: int32
description: Version of the receipt.
Price:
properties:
amount:
type: number
format: double
breakdowns:
type: array
description: 'Breakdown of the price amount describing: booked product amount, fee amount, taxes amount.'
items:
$ref: '#/components/schemas/FirstLevelBreakdown'
cost_to_customer:
type: number
format: double
description: The total cost incurred by the customer
currency:
type: string
description: ISO 4217 currency code.
example: EUR
penalties:
type: array
description: Breakdown of penalties
items:
$ref: '#/components/schemas/FirstLevelBreakdown'
refunds:
type: array
description: Breakdown of refunds
items:
$ref: '#/components/schemas/FirstLevelBreakdown'
required:
- amount
- breakdowns
- cost_to_customer
- currency
title: Price
Provider:
description: Details about ground supplier
properties:
code:
type: string
description: Code of the company
example: ZL
name:
type: string
description: Name of the company. Never provided on booking cancellation.
example: National Car Rental
required:
- code
title: Provider
Payment:
description: Details about payment.
properties:
breakdowns:
type: array
description: Breakdown of the price amount
items:
$ref: '#/components/schemas/FirstLevelBreakdown'
credit_card_info:
$ref: '#/components/schemas/CreditCardInfo'
date:
type: string
description: Date of the payment
date_time:
type: string
description: Date and time of the payment
line_type:
type: string
description: Line type. This could be PRODUCT or EGENCIA_FEE
net_amount:
$ref: '#/components/schemas/Fare'
TravelerSegmentInfo:
description: Traveler information for a segment.
properties:
ticket:
$ref: '#/components/schemas/TicketInformation'
traveler_id:
type: integer
format: int64
description: Id of the traveler.
example: 67508252738
title: TravelerSegmentInfo
Hotel:
properties:
approval_deadline:
type: string
description: Only when approval is enabled, time limit to approve/reject an item
example: '2021-04-15T15:26:00.000Z'
approval_status:
type: string
description: Only when approval is enabled.
enum:
- PENDING
- APPROVED
- DENIED
- CANCELLED
example: APPROVED
approval_triggered:
type: boolean
description: Flag to indicate whether approval got triggered for the transaction or not.
booker:
$ref: '#/components/schemas/Person'
booking_date_time:
type: string
description: The date and time the booking occurred on an itinerary.
booking_reference:
type: string
description: This is the reference of the Train, Flight, Hotel or Car booking as you can see it in your Egencia Trip Summary.
example: AZ23D
booking_status:
type: string
enum:
- BOOKED
- CANCELLED
- DRAFT
- DELETED
- AWAITING_CONFIRMATION
cancellation_date_time:
type: string
description: The date and time the booking was last cancelled.
check_in:
type: string
description: CheckIn date in days only (does not handle hour of the check in). Format = ISO 8601 datetime
example: '2019-01-01T00:00:00.000Z'
check_out:
type: string
description: Check out date in days only (does not handle hour of the check out). Format = ISO 8601 datetime
example: '2019-01-01T00:00:00.000Z'
company:
$ref: '#/components/schemas/Company'
credit_card:
$ref: '#/components/schemas/CreditCardInfo'
custom_data_fields:
type: array
deprecated: true
description: List of custom data fields. Can be company's cost centers for example.
items:
$ref: '#/components/schemas/CustomDataField'
egencia_item_id:
type: string
description: Unique identifier for the expense item in Egencia.
egencia_trip_id:
type: string
description: This Identifier is mutable and represents the Trip concept. In Egencia, Trip is the container that regroups the transactions, and this is what the user will see. It can be used to consolidate the bookings together like in Egencia.
example: 8006-8583-907
egencia_trip_link:
type: string
description: Link to trip in Egencia. SSO/Login vanity URL if the company is enabled.
expense_id:
type: string
description: Expense Transaction immutable and unique identifier for the product or service bought.
example: HL-a9fbb6cc6127cda4a4db8846dd1a9a3a6da7fd0b
expense_type:
type: string
description: Type of product.
enum:
- FLIGHT
- GROUND
- HOTEL
- TRAIN
- FEE
- CAR
expense_version:
type: integer
format: int32
description: The version of an Expense. It changes whenever a bought product has been updated.
example: 3
gds_reference:
type: string
description: External GDS (global distribution systems) reference. PNR (passenger name record) for flight.
example: ZJSZVT
links:
type: array
items:
$ref: '#/components/schemas/Link'
location:
$ref: '#/components/schemas/Location'
mission_number:
type: string
description: Partner mission order number
partner:
$ref: '#/components/schemas/Partner'
payment_method:
type: string
description: The payment mean used for the booking.
enum:
- COMPANY_FORM_OF_PAYMENT
- CREDIT_CARD
- LODGED_CARD
- ON_ACCOUNT
- VIAPAY
- PAY_AT_COUNTER
- DIRECT_BILLING
- ACCREDITIVE
- ACCREDITIVE_CARD
- COMPANY_CARD
- PREPAID_BY_ECT
point_of_sale:
$ref: '#/components/schemas/PointOfSale'
policy_compliance:
$ref: '#/components/schemas/PolicyCompliance'
price:
$ref: '#/components/schemas/Price'
property_id:
type: string
description: Unique identifier of the hotel property on the hotel distribution system
provider:
type: string
description: Where the property offering is sourced from
rate_type:
$ref: '#/components/schemas/RateType'
receipt_info:
$ref: '#/components/schemas/ReceiptInfo'
receipt_provision_available:
type: boolean
description: Indicates if receipt is generated by Egencia for this expense item.
rules_and_regulations:
$ref: '#/components/schemas/RulesAndRegulations'
star_rating:
type: string
example: 1, 2, 2.5, 3.5, .., 5
travelers:
type: array
description: The travelers who are part of this reservation.
items:
$ref: '#/components/schemas/Person'
uuid:
type: string
format: uuid
vendor_reference:
type: string
description: Product vendor reference
example: 366L3FN9E
required:
- check_in
- check_out
- company
- custom_data_fields
- egencia_item_id
- egencia_trip_id
- egencia_trip_link
- expense_id
- expense_type
- uuid
title: Hotel
Carrier:
description: Marketing carrier details
properties:
code:
type: string
description: Carrier code
low_cost_carrier:
type: boolean
description: Flag indicating whether the carrier is a low-cost.
name:
type: string
description: Carrier name
number:
type: string
description: Carrier number
title: Carrier details
Car:
properties:
amenities:
type: array
description: List of options in the vehicle, such as air conditioning
example: HandHeldNavigationSystem
items:
type: string
description: List of options in the vehicle, such as air conditioning
example: HandHeldNavigationSystem
approval_deadline:
type: string
description: Only when approval is enabled, time limit to approve/reject an item
example: '2021-04-15T15:26:00.000Z'
approval_status:
type: string
description: Only when approval is enabled.
enum:
- PENDING
- APPROVED
- DENIED
- CANCELLED
example: APPROVED
approval_triggered:
type: boolean
description: Flag to indicate whether approval got triggered for the transaction or not.
booker:
$ref: '#/components/schemas/Person'
booking_date_time:
type: string
description: The date and time the booking occurred on an itinerary.
booking_reference:
type: string
description: This is the reference of the Train, Flight, Hotel or Car booking as you can see it in your Egencia Trip Summary.
example: AZ23D
booking_status:
type: string
enum:
- BOOKED
- CANCELLED
- DRAFT
- DELETED
- AWAITING_CONFIRMATION
cancellation_date_time:
type: string
description: The date and time the booking was last cancelled.
company:
$ref: '#/components/schemas/Company'
credit_card:
$ref: '#/components/schemas/CreditCardInfo'
custom_data_fields:
type: array
deprecated: true
description: List of custom data fields. Can be company's cost centers for example.
items:
$ref: '#/components/schemas/CustomDataField'
drop_off:
$ref: '#/components/schemas/SegmentStep'
egencia_item_id:
type: string
description: Unique identifier for the expense item in Egencia.
egencia_trip_id:
type: string
description: This Identifier is mutable and represents the Trip concept. In Egencia, Trip is the container that regroups the transactions, and this is what the user will see. It can be used to consolidate the bookings together like in Egencia.
example: 8006-8583-907
egencia_trip_link:
type: string
description: Link to trip in Egencia. SSO/Login vanity URL if the company is enabled.
expense_id:
type: string
description: Expense Transaction immutable and unique identifier for the product or service bought.
example: HL-a9fbb6cc6127cda4a4db8846dd1a9a3a6da7fd0b
expense_type:
type: string
description: Type of product.
enum:
- FLIGHT
- GROUND
- HOTEL
- TRAIN
- FEE
- CAR
expense_version:
type: integer
format: int32
description: The version of an Expense. It changes whenever a bought product has been updated.
example: 3
gds_reference:
type: string
description: External GDS (global distribution systems) reference. PNR (passenger name record) for flight.
example: ZJSZVT
is_drop_off_collection:
type: boolean
description: True if the traveler will return the rental car at a custom location
is_pick_up_delivery:
type: boolean
description: True if the rental car will be delivered at a custom location to the traveler
links:
type: array
items:
$ref: '#/components/schemas/Link'
mission_number:
type: string
description: Partner mission order number
number_of_drivers:
type: integer
format: int32
description: Total number of driver, including the main driver (booker/traveler)
partner:
$ref: '#/components/schemas/Partner'
payment_method:
type: string
description: The payment mean used for the booking.
enum:
- COMPANY_FORM_OF_PAYMENT
- CREDIT_CARD
- LODGED_CARD
- ON_ACCOUNT
- VIAPAY
- PAY_AT_COUNTER
- DIRECT_BILLING
- ACCREDITIVE
- ACCREDITIVE_CARD
- COMPANY_CARD
- PREPAID_BY_ECT
pick_up:
$ref: '#/components/schemas/SegmentStep'
point_of_sale:
$ref: '#/components/schemas/PointOfSale'
policy_compliance:
$ref: '#/components/schemas/PolicyCompliance'
price:
$ref: '#/components/schemas/Price'
rate_type:
$ref: '#/components/schemas/RateType'
receipt_info:
$ref: '#/components/schemas/ReceiptInfo'
receipt_provision_available:
type: boolean
description: Indicates if receipt is generated by Egencia for this expense item.
rules_and_regulations:
$ref: '#/components/schemas/RulesAndRegulations'
travelers:
type: array
description: The travelers who are part of this reservation.
items:
$ref: '#/components/schemas/Person'
uuid:
type: string
format: uuid
vehicle:
$ref: '#/components/schemas/RentalVehicle'
vendor:
$ref: '#/components/schemas/Provider'
vendor_reference:
type: string
description: Product vendor reference
example: 366L3FN9E
required:
- company
- custom_data_fields
- drop_off
- egencia_item_id
- egencia_trip_id
- egencia_trip_link
- expense_id
- expense_type
- number_of_drivers
- pick_up
- uuid
- vendor
title: Car
FlightOriginDestination:
description: List of origins to destinations. For example a round trip would have 2 origin destination in this list (e.g. Paris -> Tokyo, Tokyo -> Paris).
properties:
segments:
type: array
description: List of segments. A trip having 1 stop will contain 2 segments (e.g. Paris -> Zurich, Zurich -> Tokyo).
items:
$ref: '#/components/schemas/Segment'
minItems: 1
required:
- segments
title: FlightOriginDestination
CreditCardInfo:
description: Credit card info
properties:
card_type:
type: string
description: Card type
first6_digits:
type: string
description: First six digits
example: '456123'
last4_digits:
type: string
description: Last four digits
example: '7878'
title: CreditCardInfo
CO2EmissionEquivalency:
description: The CO2 emission equivalencies information.
properties:
type:
type: string
description: This specifies the type of CO2 emission equivalency.
value:
type: number
format: double
description: This specifies the value of CO2 emission equivalency.
title: CO2EmissionEquivalency
Partner:
description: Partner Details
properties:
name:
type: string
description: Name of the partner
title: Partner
RentalVehicle:
description: 'Details about car vehicle (Refer: https://www.acriss.org/car-codes/)'
properties:
acriss_code:
type: string
description: 'Complete Acriss Code, (Refer: https://www.acriss.org/car-codes/), not mandatory for off line booking case'
example: IFAR
category:
type: string
description: First letter from Car ACRISS code
example: I
mileage_limit:
type: string
description: 'Mileage limit policy, without standard (e.g. : Unlimited, 0 miles (Additional Mileage: 0,40 USD per mile))'
example: '1400 km (Additional Mileage: €0.19 per km)'
name:
type: string
description: Vehicule model's name
example: Toyota Rav4
title: RentalVehicle
SubscriptionEvent:
description: Subscription event holding subscription details
properties:
partner:
$ref: '#/components/schemas/Partner'
subscriptions:
type: array
description: Subscription information
items:
$ref: '#/components/schemas/Subscription'
title: SubscriptionEvent
TicketInformation:
description: Ticket information for a segment.
properties:
number:
type: string
description: Ticket number. Only when booking is issued.
example: 0067508252738
prior_number:
type: string
description: Former ticket number if exists. For example, when a booking is exchanged.
example: 0067508252738
title: TicketInformation
FirstLevelBreakdown:
description: Details of an amount.
properties:
amount:
type: number
format: double
breakdowns:
type: array
description: Sub-breakdown of the breakdown amount. Giving further details to this amount.
items:
$ref: '#/components/schemas/SecondLevelBreakdown'
currency:
type: string
description: ISO 4217 currency code.
example: EUR
name:
type: string
example: Taxes and service fees
type:
type: string
example: TAXES
required:
- amount
- currency
- type
title: FirstLevelBreakdown
GroundVehicle:
description: 'Details about ground vehicle (Refer: https://www.acriss.org/car-codes/)'
properties:
category:
type: string
description: First letter from ACRISS code
example: I
description:
type: string
description: Description of the vehicle
example: IFAR
seating_capacity:
type: string
description: Seating Capacity
example: '1'
type:
type: string
description: Vehicle type
example: Taxi
title: GroundVehicle
SubscriptionEntity:
description: Subscribed or Unsubscribed Entity
properties:
id:
type: string
description: Identifier for the entity
name:
type: string
description: Name of the entity
title: SubscriptionEntity
SecondLevelBreakdown:
description: Sub-breakdown of the breakdown amount. Giving further details to this amount.
properties:
amount:
type: number
format: double
currency:
type: string
description: ISO 4217 currency code.
example: EUR
name:
type: string
example: Taxes and service fees
type:
type: string
example: TAXES
required:
- amount
- currency
- type
title: SecondLevelBreakdown