Skip to content

TravelPaths

Defined in: src/travel/types.gen.ts:2

/v1/trips: object

Defined in: src/travel/types.gen.ts:3

optional delete?: undefined

get: object

List trips

Lists trips according to the filters passed in the query string.

parameters: object

optional cookie?: undefined

optional header?: undefined

optional path?: undefined

optional query?: object

optional cursor?: string | null

optional last_updated_after?: string | null

optional limit?: number | null

optional requestBody?: undefined

responses: object

200: object

A page with a list of trips.

content: object

get.responses.200.content.application/json
Section titled “get.responses.200.content.application/json”

application/json: object

get.responses.200.content.application/json.items
Section titled “get.responses.200.content.application/json.items”

items: object[]

get.responses.200.content.application/json.next_cursor?
Section titled “get.responses.200.content.application/json.next_cursor?”

optional next_cursor?: string | null

headers: object

[name: string]: unknown

400: object

Bad request

optional content?: undefined

headers: object

[name: string]: unknown

401: object

Unauthorized

optional content?: undefined

headers: object

[name: string]: unknown

403: object

Forbidden

optional content?: undefined

headers: object

[name: string]: unknown

500: object

Internal server error

optional content?: undefined

headers: object

[name: string]: unknown

optional head?: undefined

optional options?: undefined

parameters: object

optional cookie?: undefined

optional header?: undefined

optional path?: undefined

optional query?: undefined

optional patch?: undefined

optional post?: undefined

optional put?: undefined

optional trace?: undefined


/v1/trips/{trip_id}: object

Defined in: src/travel/types.gen.ts:23

optional delete?: undefined

get: object

Get trip

Retrieves a trip by ID.

parameters: object

optional cookie?: undefined

optional header?: undefined

path: object

trip_id: string

optional query?: undefined

optional requestBody?: undefined

responses: object

200: object

The trip that was retrieved.

content: object

get.responses.200.content.application/json
Section titled “get.responses.200.content.application/json”

application/json: object

get.responses.200.content.application/json.billable_at?
Section titled “get.responses.200.content.application/json.billable_at?”

optional billable_at?: string | null

Format: date-time

The time when the trip became billable. If absent, the trip is currently not billable.

2017-12-27T15:42:30Z
get.responses.200.content.application/json.booker_user_id
Section titled “get.responses.200.content.application/json.booker_user_id”

booker_user_id: string

The ID of the user who booked the trip. If the trip was created on copilot mode, this will be the ID of the user on behalf of whom the trip was booked.

cuuser_cky0xs54b004h01pidi0pcuz1
get.responses.200.content.application/json.created_at
Section titled “get.responses.200.content.application/json.created_at”

created_at: string

Format: date-time

The time when the trip was created.

2017-12-27T15:42:30Z
get.responses.200.content.application/json.ends_at?
Section titled “get.responses.200.content.application/json.ends_at?”

optional ends_at?: string | null

Format: date-time

The time when the last booking in the trip ends.

2017-12-27T15:42:30Z
get.responses.200.content.application/json.id
Section titled “get.responses.200.content.application/json.id”

id: string

The ID of the trip.

trip_cl9rh1n8g001e0j84w6fb4fd1
get.responses.200.content.application/json.name?
Section titled “get.responses.200.content.application/json.name?”

optional name?: string | null

The name of the trip as seen in the dashboard.

Trip to Rio de Janeiro
get.responses.200.content.application/json.starts_at?
Section titled “get.responses.200.content.application/json.starts_at?”

optional starts_at?: string | null

Format: date-time

The time when the first booking in the trip starts.

2017-12-27T15:42:30Z
get.responses.200.content.application/json.status
Section titled “get.responses.200.content.application/json.status”

status: "DELETED" | "INVITED" | "PROCESSING" | "CANCELED" | "REFUNDED" | "DRAFT" | "IN_PROGRESS" | "APPROVAL_DENIED" | "PENDING" | "HOLD" | "COMPLETED" | "VOIDED" | "UNCONFIRMED" | "AIRLINE_CONTROL" | "PAYMENT_DECLINED" | "SCHEDULE_CHANGE" | "APPROVAL_REQUESTED" | "CANCELLATION_IN_PROGRESS" | "UPCOMING"

get.responses.200.content.application/json.traveler?
Section titled “get.responses.200.content.application/json.traveler?”

optional traveler?: object

get.responses.200.content.application/json.traveler.guest_email?
Section titled “get.responses.200.content.application/json.traveler.guest_email?”

optional guest_email?: string | null

If the traveler is a guest, this is their email.

guest@gmail.com
get.responses.200.content.application/json.traveler.name?
Section titled “get.responses.200.content.application/json.traveler.name?”

optional name?: object

get.responses.200.content.application/json.traveler.name.first_name?
Section titled “get.responses.200.content.application/json.traveler.name.first_name?”

optional first_name?: … | …

The traveler’s first name.

John
get.responses.200.content.application/json.traveler.name.last_name?
Section titled “get.responses.200.content.application/json.traveler.name.last_name?”

optional last_name?: … | …

The traveler’s last name.

Doe
get.responses.200.content.application/json.traveler.name.middle_name?
Section titled “get.responses.200.content.application/json.traveler.name.middle_name?”

optional middle_name?: … | … | …

The traveler’s middle name.

Paul
get.responses.200.content.application/json.traveler.name.suffix?
Section titled “get.responses.200.content.application/json.traveler.name.suffix?”

optional suffix?: … | … | …

The suffix in the traveler’s name.

Jr.
get.responses.200.content.application/json.traveler.type
Section titled “get.responses.200.content.application/json.traveler.type”

type: "EMPLOYEE" | "GUEST"

get.responses.200.content.application/json.traveler.user_id?
Section titled “get.responses.200.content.application/json.traveler.user_id?”

optional user_id?: string | null

If the traveler is an employee, this is their user ID.

cuuser_cky0xs54b004h01pidi0pcuz1
get.responses.200.content.application/json.updated_at
Section titled “get.responses.200.content.application/json.updated_at”

updated_at: string

Format: date-time

The time when the latest trip update happened.

2017-12-27T15:42:30Z
get.responses.200.content.application/json.version
Section titled “get.responses.200.content.application/json.version”

version: number

Format: int32

The current version of the trip.

2

headers: object

[name: string]: unknown

400: object

Bad request

optional content?: undefined

headers: object

[name: string]: unknown

401: object

Unauthorized

optional content?: undefined

headers: object

[name: string]: unknown

403: object

Forbidden

optional content?: undefined

headers: object

[name: string]: unknown

404: object

Not Found

optional content?: undefined

headers: object

[name: string]: unknown

500: object

Internal server error

optional content?: undefined

headers: object

[name: string]: unknown

optional head?: undefined

optional options?: undefined

parameters: object

optional cookie?: undefined

optional header?: undefined

optional path?: undefined

optional query?: undefined

optional patch?: undefined

optional post?: undefined

optional put?: undefined

optional trace?: undefined


/v1/trips/{trip_id}/bookings: object

Defined in: src/travel/types.gen.ts:43

optional delete?: undefined

get: object

List trip bookings

Lists the bookings within a trip.

parameters: object

optional cookie?: undefined

optional header?: undefined

path: object

trip_id: string

optional query?: object

optional cursor?: string | null

optional limit?: number | null

optional requestBody?: undefined

responses: object

200: object

A page with a list of bookings.

content: object

get.responses.200.content.application/json
Section titled “get.responses.200.content.application/json”

application/json: object

get.responses.200.content.application/json.items
Section titled “get.responses.200.content.application/json.items”

items: object[]

get.responses.200.content.application/json.next_cursor?
Section titled “get.responses.200.content.application/json.next_cursor?”

optional next_cursor?: string | null

headers: object

[name: string]: unknown

400: object

Bad request

optional content?: undefined

headers: object

[name: string]: unknown

401: object

Unauthorized

optional content?: undefined

headers: object

[name: string]: unknown

403: object

Forbidden

optional content?: undefined

headers: object

[name: string]: unknown

404: object

Not Found

optional content?: undefined

headers: object

[name: string]: unknown

500: object

Internal server error

optional content?: undefined

headers: object

[name: string]: unknown

optional head?: undefined

optional options?: undefined

parameters: object

optional cookie?: undefined

optional header?: undefined

optional path?: undefined

optional query?: undefined

optional patch?: undefined

optional post?: undefined

optional put?: undefined

optional trace?: undefined


/v1/trips/{trip_id}/bookings/{booking_id}: object

Defined in: src/travel/types.gen.ts:63

optional delete?: undefined

get: object

Get booking

Retrieves a booking by trip and booking ID.

parameters: object

optional cookie?: undefined

optional header?: undefined

path: object

booking_id: string

trip_id: string

optional query?: undefined

optional requestBody?: undefined

responses: object

200: object

The booking that was retrieved.

content: object

get.responses.200.content.application/json
Section titled “get.responses.200.content.application/json”

application/json: object

get.responses.200.content.application/json.booking_data
Section titled “get.responses.200.content.application/json.booking_data”

booking_data: { journeys: object[]; known_traveler_number?: { document_number: string; issuing_country: string; }; redress_number?: { document_number: string; issuing_country: string; }; tickets: object[]; type: "AIR"; } | { car_details: { car_class?: "OTHER" | "ECONOMY" | "COMPACT" | "INTERMEDIATE" | "PREMIUM" | "LUXURY" | "CONVERTIBLE" | "COMPACT_SUV" | "INTERMEDIATE_SUV" | "PREMIUM_SUV" | "LUXURY_SUV" | "MINI_VAN" | "PASSENGER_VAN" | "PICKUP_TRUCK" | "HYBRID" | "ELECTRIC" | "MINI" | "STANDARD" | "FULL_SIZE" | "SUV" | "SPORTS" | "SPECIAL" | "RECREATIONAL_VEHICLE"; display_name: string; }; reservation_details: { confirmation_code?: string | null; drop_off: { location: { address_line_1?: …; address_line_2?: …; administrative_area?: …; city?: …; coordinates?: …; country?: …; postal_code?: …; timezone?: …; }; time: { local_time: …; timestamp?: …; }; }; pickup: { location: { address_line_1?: …; address_line_2?: …; administrative_area?: …; city?: …; coordinates?: …; country?: …; postal_code?: …; timezone?: …; }; time: { local_time: …; timestamp?: …; }; }; rental_company?: string | null; }; type: "CAR_RENTAL"; } | { lodging_details: { brand_name?: string | null; chain_name?: string | null; contact_information?: { email?: …; fax?: …; phone?: …; }; display_name: string; location?: { address_line_1?: …; address_line_2?: …; administrative_area?: …; city?: …; coordinates?: …; country?: …; postal_code?: …; timezone?: …; }; star_rating?: number | null; }; reservation_details: { check_in_time: { local_time: string; timestamp?: … | … | …; }; checkout_time: { local_time: string; timestamp?: … | … | …; }; confirmation_code?: string | null; room?: { bed_count?: …; bed_type?: …; description?: …; display_name?: …; }; }; type: "LODGING"; } | { journeys: object[]; type: "RAIL"; }

{ journeys: object[]; known_traveler_number?: { document_number: string; issuing_country: string; }; redress_number?: { document_number: string; issuing_country: string; }; tickets: object[]; type: "AIR"; }

journeys: object[]

The journeys that make up this booking.

optional known_traveler_number?: object

document_number: string

The actual document number.

1231231

issuing_country: string

The country that issued this document.

BR

optional redress_number?: object

document_number: string

The actual document number.

1231231

issuing_country: string

The country that issued this document.

BR

tickets: object[]

The flight tickets in this booking.

type: "AIR"

discriminator enum property added by openapi-typescript


{ car_details: { car_class?: "OTHER" | "ECONOMY" | "COMPACT" | "INTERMEDIATE" | "PREMIUM" | "LUXURY" | "CONVERTIBLE" | "COMPACT_SUV" | "INTERMEDIATE_SUV" | "PREMIUM_SUV" | "LUXURY_SUV" | "MINI_VAN" | "PASSENGER_VAN" | "PICKUP_TRUCK" | "HYBRID" | "ELECTRIC" | "MINI" | "STANDARD" | "FULL_SIZE" | "SUV" | "SPORTS" | "SPECIAL" | "RECREATIONAL_VEHICLE"; display_name: string; }; reservation_details: { confirmation_code?: string | null; drop_off: { location: { address_line_1?: …; address_line_2?: …; administrative_area?: …; city?: …; coordinates?: …; country?: …; postal_code?: …; timezone?: …; }; time: { local_time: …; timestamp?: …; }; }; pickup: { location: { address_line_1?: …; address_line_2?: …; administrative_area?: …; city?: …; coordinates?: …; country?: …; postal_code?: …; timezone?: …; }; time: { local_time: …; timestamp?: …; }; }; rental_company?: string | null; }; type: "CAR_RENTAL"; }

car_details: object

optional car_class?: "OTHER" | "ECONOMY" | "COMPACT" | "INTERMEDIATE" | "PREMIUM" | "LUXURY" | "CONVERTIBLE" | "COMPACT_SUV" | "INTERMEDIATE_SUV" | "PREMIUM_SUV" | "LUXURY_SUV" | "MINI_VAN" | "PASSENGER_VAN" | "PICKUP_TRUCK" | "HYBRID" | "ELECTRIC" | "MINI" | "STANDARD" | "FULL_SIZE" | "SUV" | "SPORTS" | "SPECIAL" | "RECREATIONAL_VEHICLE"

display_name: string

The name of the car as displayed to the user.

Intermediate car

reservation_details: object

optional confirmation_code?: string | null

The confirmation code given by the vendor.

7003XBQ504

drop_off: object

location: object

reservation_details.drop_off.location.address_line_1?
Section titled “reservation_details.drop_off.location.address_line_1?”

optional address_line_1?: …

The first line of the address.

Av. Vinte de Janeiro, S/N
reservation_details.drop_off.location.address_line_2?
Section titled “reservation_details.drop_off.location.address_line_2?”

optional address_line_2?: …

The second line of the address.

Ilha do Governador
reservation_details.drop_off.location.administrative_area?
Section titled “reservation_details.drop_off.location.administrative_area?”

optional administrative_area?: …

Depending on the country, this can be a state, a province, or something equivalent to those. May be an abbreviation or the full name.

RJ
reservation_details.drop_off.location.city?
Section titled “reservation_details.drop_off.location.city?”

optional city?: …

The city where the address is located.

Rio de Janeiro
reservation_details.drop_off.location.coordinates?
Section titled “reservation_details.drop_off.location.coordinates?”

optional coordinates?: …

reservation_details.drop_off.location.country?
Section titled “reservation_details.drop_off.location.country?”

optional country?: …

The country where the address is located. May be an alpha-2 code, an alpha-3 code, or the full name of the country.

Brazil
reservation_details.drop_off.location.postal_code?
Section titled “reservation_details.drop_off.location.postal_code?”

optional postal_code?: …

The postal code of the given address.

21941-900
reservation_details.drop_off.location.timezone?
Section titled “reservation_details.drop_off.location.timezone?”

optional timezone?: …

The timezone in the given address.

America/Sao_Paulo

time: object

reservation_details.drop_off.time.local_time
Section titled “reservation_details.drop_off.time.local_time”

local_time: …

Format: date-time

The local time in the relevant location in the ISO 8601 format.

reservation_details.drop_off.time.timestamp?
Section titled “reservation_details.drop_off.time.timestamp?”

optional timestamp?: …

Format: date-time

An ISO 8601 timestamp.

2017-12-27T15:42:30Z

pickup: object

location: object

reservation_details.pickup.location.address_line_1?
Section titled “reservation_details.pickup.location.address_line_1?”

optional address_line_1?: …

The first line of the address.

Av. Vinte de Janeiro, S/N
reservation_details.pickup.location.address_line_2?
Section titled “reservation_details.pickup.location.address_line_2?”

optional address_line_2?: …

The second line of the address.

Ilha do Governador
reservation_details.pickup.location.administrative_area?
Section titled “reservation_details.pickup.location.administrative_area?”

optional administrative_area?: …

Depending on the country, this can be a state, a province, or something equivalent to those. May be an abbreviation or the full name.

RJ

optional city?: …

The city where the address is located.

Rio de Janeiro
reservation_details.pickup.location.coordinates?
Section titled “reservation_details.pickup.location.coordinates?”

optional coordinates?: …

reservation_details.pickup.location.country?
Section titled “reservation_details.pickup.location.country?”

optional country?: …

The country where the address is located. May be an alpha-2 code, an alpha-3 code, or the full name of the country.

Brazil
reservation_details.pickup.location.postal_code?
Section titled “reservation_details.pickup.location.postal_code?”

optional postal_code?: …

The postal code of the given address.

21941-900
reservation_details.pickup.location.timezone?
Section titled “reservation_details.pickup.location.timezone?”

optional timezone?: …

The timezone in the given address.

America/Sao_Paulo

time: object

reservation_details.pickup.time.local_time
Section titled “reservation_details.pickup.time.local_time”

local_time: …

Format: date-time

The local time in the relevant location in the ISO 8601 format.

reservation_details.pickup.time.timestamp?
Section titled “reservation_details.pickup.time.timestamp?”

optional timestamp?: …

Format: date-time

An ISO 8601 timestamp.

2017-12-27T15:42:30Z

optional rental_company?: string | null

Name of car rental company.

Catch-A-Ride

type: "CAR_RENTAL"

discriminator enum property added by openapi-typescript


{ lodging_details: { brand_name?: string | null; chain_name?: string | null; contact_information?: { email?: …; fax?: …; phone?: …; }; display_name: string; location?: { address_line_1?: …; address_line_2?: …; administrative_area?: …; city?: …; coordinates?: …; country?: …; postal_code?: …; timezone?: …; }; star_rating?: number | null; }; reservation_details: { check_in_time: { local_time: string; timestamp?: … | … | …; }; checkout_time: { local_time: string; timestamp?: … | … | …; }; confirmation_code?: string | null; room?: { bed_count?: …; bed_type?: …; description?: …; display_name?: …; }; }; type: "LODGING"; }

lodging_details: object

optional brand_name?: string | null

The brand name of the hotel.

Marriott Hotels

optional chain_name?: string | null

The name of the hotel chain.

Accor Hotels

optional contact_information?: object

lodging_details.contact_information.email?
Section titled “lodging_details.contact_information.email?”

optional email?: …

The email address of the venue.

city@hotelchain.com

optional fax?: …

The fax number of the venue.

12345554321
lodging_details.contact_information.phone?
Section titled “lodging_details.contact_information.phone?”

optional phone?: …

The phone number of the venue.

12345554321

display_name: string

The name of the venue as displayed to the user.

Fancy Hotel

optional location?: object

optional address_line_1?: …

The first line of the address.

Av. Vinte de Janeiro, S/N

optional address_line_2?: …

The second line of the address.

Ilha do Governador
lodging_details.location.administrative_area?
Section titled “lodging_details.location.administrative_area?”

optional administrative_area?: …

Depending on the country, this can be a state, a province, or something equivalent to those. May be an abbreviation or the full name.

RJ

optional city?: …

The city where the address is located.

Rio de Janeiro

optional coordinates?: …

optional country?: …

The country where the address is located. May be an alpha-2 code, an alpha-3 code, or the full name of the country.

Brazil

optional postal_code?: …

The postal code of the given address.

21941-900

optional timezone?: …

The timezone in the given address.

America/Sao_Paulo

optional star_rating?: number | null

Format: float

The star rating of the hotel. Some hotels have half stars.

3.5

reservation_details: object

check_in_time: object

reservation_details.check_in_time.local_time
Section titled “reservation_details.check_in_time.local_time”

local_time: string

Format: date-time

The local time in the relevant location in the ISO 8601 format.

reservation_details.check_in_time.timestamp?
Section titled “reservation_details.check_in_time.timestamp?”

optional timestamp?: … | … | …

Format: date-time

An ISO 8601 timestamp.

2017-12-27T15:42:30Z

checkout_time: object

reservation_details.checkout_time.local_time
Section titled “reservation_details.checkout_time.local_time”

local_time: string

Format: date-time

The local time in the relevant location in the ISO 8601 format.

reservation_details.checkout_time.timestamp?
Section titled “reservation_details.checkout_time.timestamp?”

optional timestamp?: … | … | …

Format: date-time

An ISO 8601 timestamp.

2017-12-27T15:42:30Z

optional confirmation_code?: string | null

Confirmation code provided by the vendor.

7003XBQ504

optional room?: object

optional bed_count?: …

Format: int32

The number of beds.

1

optional bed_type?: …

The kind of bed.

DOUBLE

optional description?: …

A description of the room.

Superior room

optional display_name?: …

The name of the room as displayed to the user.

Standard room

type: "LODGING"

discriminator enum property added by openapi-typescript


{ journeys: object[]; type: "RAIL"; }

journeys: object[]

The journeys that make up this booking.

type: "RAIL"

discriminator enum property added by openapi-typescript

get.responses.200.content.application/json.created_at
Section titled “get.responses.200.content.application/json.created_at”

created_at: string

Format: date-time

The time when the booking was created.

2017-12-27T15:42:30Z
get.responses.200.content.application/json.id
Section titled “get.responses.200.content.application/json.id”

id: string

The ID of the booking.

booking_cl9t5dnu800040m3071dandeq
get.responses.200.content.application/json.source
Section titled “get.responses.200.content.application/json.source”

source: "BREX_TRAVEL" | "EXTERNAL"

get.responses.200.content.application/json.status
Section titled “get.responses.200.content.application/json.status”

status: "PROCESSING" | "CANCELED" | "REFUNDED" | "IN_PROGRESS" | "APPROVAL_DENIED" | "PENDING" | "CONFIRMED" | "HOLD" | "COMPLETED" | "VOIDED" | "UNCONFIRMED" | "AIRLINE_CONTROL" | "PAYMENT_DECLINED" | "SCHEDULE_CHANGE" | "APPROVAL_REQUESTED" | "CANCELLATION_IN_PROGRESS"

get.responses.200.content.application/json.trip_id
Section titled “get.responses.200.content.application/json.trip_id”

trip_id: string

The ID of the trip to which this booking belongs.

trip_cl9rh1n8g001e0j84w6fb4fd1
get.responses.200.content.application/json.type
Section titled “get.responses.200.content.application/json.type”

type: "CAR_RENTAL" | "LODGING" | "AIR" | "RAIL"

get.responses.200.content.application/json.updated_at
Section titled “get.responses.200.content.application/json.updated_at”

updated_at: string

Format: date-time

The time when the booking was last updated.

2017-12-27T15:42:30Z
get.responses.200.content.application/json.version
Section titled “get.responses.200.content.application/json.version”

version: number

Format: int32

The current version of the booking.

2

headers: object

[name: string]: unknown

400: object

Bad request

optional content?: undefined

headers: object

[name: string]: unknown

401: object

Unauthorized

optional content?: undefined

headers: object

[name: string]: unknown

403: object

Forbidden

optional content?: undefined

headers: object

[name: string]: unknown

404: object

Not Found

optional content?: undefined

headers: object

[name: string]: unknown

500: object

Internal server error

optional content?: undefined

headers: object

[name: string]: unknown

optional head?: undefined

optional options?: undefined

parameters: object

optional cookie?: undefined

optional header?: undefined

optional path?: undefined

optional query?: undefined

optional patch?: undefined

optional post?: undefined

optional put?: undefined

optional trace?: undefined