--- title: "Get booking" method: GET path: "/v1/trips/{trip_id}/bookings/{booking_id}" tags: ["Trips"] --- # Get booking `GET /v1/trips/{trip_id}/bookings/{booking_id}` Retrieves a booking by trip and booking ID. ## Path parameters - `trip_id` string, required - `booking_id` string, required ## Response `200` The booking that was retrieved. - Booking — A booking representation. - `id` string, required — The ID of the booking. - `created_at` string, date-time, required — The time when the booking was created. - `updated_at` string, date-time, required — The time when the booking was last updated. - `trip_id` string, required — The ID of the trip to which this booking belongs. - `version` integer, required — The current version of the booking. - `type` 'AIR' | 'CAR_RENTAL' | 'LODGING' | 'RAIL', required — The type of a booking. - `status` 'HOLD' | 'PENDING' | 'CONFIRMED' | 'COMPLETED' | 'CANCELED' | 'IN_PROGRESS' | 'REFUNDED' | 'VOIDED' | 'PROCESSING' | 'UNCONFIRMED' | 'AIRLINE_CONTROL' | 'PAYMENT_DECLINED' | 'SCHEDULE_CHANGE' | 'APPROVAL_REQUESTED' | 'APPROVAL_DENIED' | 'CANCELLATION_IN_PROGRESS', required — The status of the booking: * `HOLD` - The booking is a hold, and may be canceled without being charged. * `PENDING` - Some action needs to be completed before the booking is confirmed. Usually the action is the payment being confirmed. * `CONFIRMED` - The booking is confirmed. * `COMPLETED` - The booking has already happened. * `CANCELED` - The booking has been canceled. * `IN_PROGRESS` - The booking is currently in progress. * `REFUNDED` - A refund has been issued. It may or may not be a full refund. * `VOIDED` - Voided is similar to (and can be treated the same as) canceled. * `PROCESSING` - The booking has been created or changed, but confirmation from the vendor has not been received yet. * `UNCONFIRMED` - The booking was in the `PROCESSING` state for too long and some action is probably required to get this booking confirmed. * `AIRLINE_CONTROL` - The airline has taken control of the booking and further updates may not be visible. * `PAYMENT_DECLINED` - The payment for the booking has failed. * `SCHEDULE_CHANGE` - Some change has happened to the booking schedule, e.g. the flight getting canceled and the passenger reallocated to another flight. Travel support should reach out to confirm the traveler accepts the new schedule. * `APPROVAL_REQUESTED` - The booking is subject to approval, and it is waiting for a review. * `APPROVAL_DENIED` - A reviewer has denied the booking, or the deadline to approve the booking has passed and it got canceled. * `CANCELLATION_IN_PROGRESS` - The booking is currently being canceled. - `source` 'BREX_TRAVEL' | 'EXTERNAL', required — The original source of a booking: * `BREX_TRAVEL` - The booking was created via Brex Travel. * `EXTERNAL` - The booking was manually inserted, e.g. a hotel room block for a group event. - `booking_data` union, required — Type-specific booking data. - object — Air-specific booking information. - `journeys` AirBookingDataJourney[], required — The journeys that make up this booking. - `flights` AirBookingDataFlight[], required — The flights that make up this journey. - `origin` AirBookingDataFlightEndpoint, required — The place where a flight departs from or arrives at. - `airport_code` string, required — The 3-letter IATA code of the airport. - `terminal` string, nullable — The terminal name and/or number. - `gate` string, nullable — The gate for boarding or leaving the plane. - `airport_location` object, nullable — The location of the airport. - … - `destination` AirBookingDataFlightEndpoint, required — The place where a flight departs from or arrives at. - `airport_code` string, required — The 3-letter IATA code of the airport. - `terminal` string, nullable — The terminal name and/or number. - `gate` string, nullable — The gate for boarding or leaving the plane. - `airport_location` object, nullable — The location of the airport. - … - `departure_time` object, required — The time when the flight departs the origin. - `local_time` string, date-time, required — The local time in the relevant location in the ISO 8601 format. - `timestamp` string, date-time, nullable — An ISO 8601 timestamp. - `arrival_time` object, required — The time when the flight arrives at the destination. - `local_time` string, date-time, required — The local time in the relevant location in the ISO 8601 format. - `timestamp` string, date-time, nullable — An ISO 8601 timestamp. - `duration` string, nullable — The duration of the flight in the ISO 8601 PnYnMnDTnHnMnS format. - `confirmation_code` string, nullable — The airline confirmation code. - `cabin_class` 'ECONOMY' | 'PREMIUM_ECONOMY' | 'BUSINESS' | 'FIRST', nullable — The cabin class for this flight. - `marketing_flight` object, nullable — The marketing flight number. Some flights are sold by one airline, but operated by another in the same alliance. This is the flight that was originally sold. - `airline_code` string, required — The IATA code for the airline. - `number` string, required — The number of the flight. - `airline_name` string, nullable — The name of the airline. - `operating_flight` object, nullable — The operating flight number. Some flights are sold by one airline, but operated by another in the same alliance. This is the flight the traveler is actually taking. - `airline_code` string, required — The IATA code for the airline. - `number` string, required — The number of the flight. - `airline_name` string, nullable — The name of the airline. - `seat` object, nullable — The seat reserved for this flight. - `number` string, required — The seat number. - `status` 'PENDING' | 'CONFIRMED' | 'CANCELED', nullable — The status of a flight seat. - `status` 'HOLD' | 'PENDING' | 'CONFIRMED' | 'COMPLETED' | 'CANCELED' | 'IN_PROGRESS' | 'REFUNDED' | 'VOIDED' | 'PROCESSING' | 'UNCONFIRMED' | 'AIRLINE_CONTROL' | 'PAYMENT_DECLINED' | 'SCHEDULE_CHANGE' | 'APPROVAL_REQUESTED' | 'APPROVAL_DENIED' | 'CANCELLATION_IN_PROGRESS', required — The status of this specific journey. - `cabin_display_name` string, nullable — The cabin name as shown by the airline. - `tickets` AirBookingDataFlightTicket[], required — The flight tickets in this booking. - `number` string, required — The ticket number provided by the airline. - `issue_date` string, date, nullable — The date when the ticket was issued. - `redress_number` object, nullable — The Redress Number associated with this booking. - `issuing_country` string, required — The country that issued this document. - `document_number` string, required — The actual document number. - `known_traveler_number` object, nullable — The Known Traveler Number associated with this booking. - `issuing_country` string, required — The country that issued this document. - `document_number` string, required — The actual document number. - `type` string - object — Car rental-specific booking information. - `car_details` CarRentalBookingDataCarDetails, required — Information on a rental car. - `display_name` string, required — The name of the car as displayed to the user. - `car_class` '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' | 'OTHER', nullable — The kind of car. - `reservation_details` CarRentalBookingDataReservationDetails, required — Information on a car reservation such as pickup, drop-off, etc. - `confirmation_code` string, nullable — The confirmation code given by the vendor. - `pickup` object, required — Information on the car pickup. - `location` object, required — The location where the car can be picked up or where it must be returned. - `country` string, nullable — The country where the address is located. May be an alpha-2 code, an alpha-3 code, or the full name of the country. - `administrative_area` string, nullable — Depending on the country, this can be a state, a province, or something equivalent to those. May be an abbreviation or the full name. - `city` string, nullable — The city where the address is located. - `postal_code` string, nullable — The postal code of the given address. - `address_line_1` string, nullable — The first line of the address. - `address_line_2` string, nullable — The second line of the address. - `coordinates` object, nullable — The coordinates of the address. - … - `timezone` string, nullable — The timezone in the given address. - `time` object, required — The time when the car will be available for pickup or by when it must be returned. - `local_time` string, date-time, required — The local time in the relevant location in the ISO 8601 format. - `timestamp` string, date-time, nullable — An ISO 8601 timestamp. - `drop_off` object, required — Information on the car return. - `location` object, required — The location where the car can be picked up or where it must be returned. - `country` string, nullable — The country where the address is located. May be an alpha-2 code, an alpha-3 code, or the full name of the country. - `administrative_area` string, nullable — Depending on the country, this can be a state, a province, or something equivalent to those. May be an abbreviation or the full name. - `city` string, nullable — The city where the address is located. - `postal_code` string, nullable — The postal code of the given address. - `address_line_1` string, nullable — The first line of the address. - `address_line_2` string, nullable — The second line of the address. - `coordinates` object, nullable — The coordinates of the address. - … - `timezone` string, nullable — The timezone in the given address. - `time` object, required — The time when the car will be available for pickup or by when it must be returned. - `local_time` string, date-time, required — The local time in the relevant location in the ISO 8601 format. - `timestamp` string, date-time, nullable — An ISO 8601 timestamp. - `rental_company` string, nullable — Name of car rental company. - `type` string - object — Lodging-specific booking information. - `lodging_details` LodgingBookingDataLodgingDetails, required — Information on a lodging venue. - `display_name` string, required — The name of the venue as displayed to the user. - `contact_information` object, nullable — Contact information of a venue. - `phone` string, nullable — The phone number of the venue. - `fax` string, nullable — The fax number of the venue. - `email` string, nullable — The email address of the venue. - `star_rating` number, float, nullable — The star rating of the hotel. Some hotels have half stars. - `brand_name` string, nullable — The brand name of the hotel. - `chain_name` string, nullable — The name of the hotel chain. - `location` object, nullable — The location of the hotel. - `country` string, nullable — The country where the address is located. May be an alpha-2 code, an alpha-3 code, or the full name of the country. - `administrative_area` string, nullable — Depending on the country, this can be a state, a province, or something equivalent to those. May be an abbreviation or the full name. - `city` string, nullable — The city where the address is located. - `postal_code` string, nullable — The postal code of the given address. - `address_line_1` string, nullable — The first line of the address. - `address_line_2` string, nullable — The second line of the address. - `coordinates` object, nullable — The coordinates of the address. - `latitude` number, double, required - `longitude` number, double, required - `timezone` string, nullable — The timezone in the given address. - `reservation_details` LodgingBookingDataReservationDetails, required — Information on a reservation such as check-in, checkout, etc. - `confirmation_code` string, nullable — Confirmation code provided by the vendor. - `check_in_time` object, required — The time when check-in will be available. - `local_time` string, date-time, required — The local time in the relevant location in the ISO 8601 format. - `timestamp` string, date-time, nullable — An ISO 8601 timestamp. - `checkout_time` object, required — The time limit for checkout. - `local_time` string, date-time, required — The local time in the relevant location in the ISO 8601 format. - `timestamp` string, date-time, nullable — An ISO 8601 timestamp. - `room` object, nullable — Information on a room that was booked. - `display_name` string, nullable — The name of the room as displayed to the user. - `description` string, nullable — A description of the room. - `bed_type` string, nullable — The kind of bed. - `bed_count` integer, nullable — The number of beds. - `type` string - object — Rail-specific booking information. - `journeys` RailBookingDataRailJourney[], required — The journeys that make up this booking. - `legs` RailBookingDataRailLeg[], required — The legs that make up this journey. - `origin` RailBookingDataRailStation, required — An endpoint in a rail leg. - `name` string, nullable — The name of the station. - `location` object, nullable — The location of the station. - … - `type` 'INDIVIDUAL' | 'GROUP' | 'METRO' | 'BUS_STOP' | 'FERRY_TERMINAL', nullable — The kind of station. Some rail itineraries include taking a bus or walking between stations, and these are represented as legs in the journey. * `INDIVIDUAL` - A regular train station. * `GROUP` - Stations grouped together, usually in a major European city. E.g. "London, Any". * `METRO` - A metro/subway station. * `BUS_STOP` - A bus stop. * `FERRY_TERMINAL` - A ferry terminal. - `destination` RailBookingDataRailStation, required — An endpoint in a rail leg. - `name` string, nullable — The name of the station. - `location` object, nullable — The location of the station. - … - `type` 'INDIVIDUAL' | 'GROUP' | 'METRO' | 'BUS_STOP' | 'FERRY_TERMINAL', nullable — The kind of station. Some rail itineraries include taking a bus or walking between stations, and these are represented as legs in the journey. * `INDIVIDUAL` - A regular train station. * `GROUP` - Stations grouped together, usually in a major European city. E.g. "London, Any". * `METRO` - A metro/subway station. * `BUS_STOP` - A bus stop. * `FERRY_TERMINAL` - A ferry terminal. - `departure_time` object, required — The time when the leg starts. - `local_time` string, date-time, required — The local time in the relevant location in the ISO 8601 format. - `timestamp` string, date-time, nullable — An ISO 8601 timestamp. - `arrival_time` object, required — The time when the leg ends. - `local_time` string, date-time, required — The local time in the relevant location in the ISO 8601 format. - `timestamp` string, date-time, nullable — An ISO 8601 timestamp. - `duration` string, nullable — PT4h20M - `vehicle` object, nullable — The vehicle that will be used in this leg. - `carrier` string, nullable — The carrier that operates this leg. E.g. Amtrak, Thameslink. - `timetable_id` string, nullable — The timetable ID for the vehicle. The concept is similar to a flight number. - `type` 'TRAIN' | 'BUS' | 'FERRY' | 'WALK' | 'TAXI' | 'TRAM' | 'METRO' | 'TUBE', nullable — The kind of vehicle to be used in a leg. Some rail itineraries include taking a bus or walking between stations, and these are represented as legs in the journey. * `TRAIN` - A regular train. * `BUS` - A bus. * `FERRY` - A ferry. * `WALK`- Walking between stations. * `TAXI` - A taxi between stations. * `TRAM` - Tram/light rail. * `METRO` - Metro/subway. * `TUBE` - London underground. - `seat` object, nullable — The seat that has been reserved for this leg. - `coach_number` string, nullable — The number of the coach. - `seat_number` string, nullable — The number of the seat. - `rail_class` 'FIRST' | 'STANDARD' | 'BUSINESS' | 'SLEEPER' | 'STANDARD_PREMIUM' | 'BUSINESS_PREMIUM' | 'COACH' | 'ROOM' | 'EXECUTIVE', nullable — The class of travel for a rail leg. - `type` string - `booking_reference` string, nullable — The booking reference number shown in the dashboard and used when contacting Brex Support. This is the reference from the travel provider, not the Brex internal booking ID. May be null if the booking has no associated reference. - `trip_reference` string, nullable — The trip reference number shown in the dashboard and used when contacting Brex Support. This is the reference from the travel provider, not the Brex internal trip ID. May be null if the trip has no associated reference. ## Other responses - `400` — Bad request - `401` — Unauthorized - `403` — Forbidden - `404` — Not Found - `500` — Internal server error --- [API](https://skmtc.net/brex-com/apis/travel-api.md) · [All operations](https://skmtc.net/brex-com/apis/travel-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brex-com/travel-api/versions/ab632cfd06cf/schema)