---
title: "Get trip"
method: GET
path: "/v1/trips/{trip_id}"
tags: ["Trips"]
---

# Get trip

`GET /v1/trips/{trip_id}`

Retrieves a trip by ID.

## Path parameters

- `trip_id` string, required

## Query parameters

- `load_custom_fields` boolean, nullable

## Response `200`

The trip that was retrieved.

- Trip — A trip representation.
  - `id` string, required — The ID of the trip.
  - `created_at` string, date-time, required — The time when the trip was created.
  - `updated_at` string, date-time, required — The time when the latest trip update happened.
  - `name` string, nullable — The name of the trip as seen in the dashboard.
  - `booker_user_id` string, required — 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.
  - `status` 'PENDING' | 'UPCOMING' | 'IN_PROGRESS' | 'COMPLETED' | 'CANCELED' | 'REFUNDED' | 'VOIDED' | 'DRAFT' | 'DELETED' | 'PROCESSING' | 'UNCONFIRMED' | 'AIRLINE_CONTROL' | 'PAYMENT_DECLINED' | 'SCHEDULE_CHANGE' | 'HOLD' | 'APPROVAL_REQUESTED' | 'APPROVAL_DENIED' | 'CANCELLATION_IN_PROGRESS', required — The current status of the trip.
  - `traveler` object, nullable — Information on the person who will be traveling.
    - `type` 'EMPLOYEE' | 'GUEST', required — Whether the trip is for an employee or a guest.
    - `name` object, nullable — The name of the traveler.
      - `first_name` string — The traveler's first name.
      - `middle_name` string, nullable — The traveler's middle name.
      - `last_name` string — The traveler's last name.
      - `suffix` string, nullable — The suffix in the traveler's name.
    - `guest_email` string, nullable — If the traveler is a guest, this is their email.
    - `user_id` string, nullable — If the traveler is an employee, this is their user ID.
  - `version` integer, required — The current version of the trip.
  - `billable_at` string, date-time, nullable — The time when the trip became billable. If absent, the trip is currently not billable.
  - `starts_at` string, date-time, nullable — The time when the first booking in the trip starts.
  - `ends_at` string, date-time, nullable — The time when the last booking in the trip ends.
  - `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.
  - `custom_fields` CustomField[], nullable — Custom field values associated with this resource.
    - `key` string, required — The key of the custom field.
    - `value` union, required
      - object — Base class for custom field values
        - `value_type` 'SINGLE_VALUE' | 'LIST', required — The type of the custom field value.
        - `data_type` 'STRING' | 'DECIMAL' | 'BOOLEAN' | 'ENUM' | 'TIMESTAMP' | 'DATE' | 'MONEY' | 'OPTION_STRING', required — The type of the custom field data.
        - `data` string, nullable — The data of the custom field.
      - object — Base class for custom field values
        - `value_type` 'SINGLE_VALUE' | 'LIST', required — The type of the custom field value.
        - `data_type` 'STRING' | 'DECIMAL' | 'BOOLEAN' | 'ENUM' | 'TIMESTAMP' | 'DATE' | 'MONEY' | 'OPTION_STRING', required — The type of the custom field data.
        - `data` number, nullable — The data of the custom field.
      - object — Base class for custom field values
        - `value_type` 'SINGLE_VALUE' | 'LIST', required — The type of the custom field value.
        - `data_type` 'STRING' | 'DECIMAL' | 'BOOLEAN' | 'ENUM' | 'TIMESTAMP' | 'DATE' | 'MONEY' | 'OPTION_STRING', required — The type of the custom field data.
        - `data` boolean, nullable — The data of the custom field.
      - object — Base class for custom field values
        - `value_type` 'SINGLE_VALUE' | 'LIST', required — The type of the custom field value.
        - `data_type` 'STRING' | 'DECIMAL' | 'BOOLEAN' | 'ENUM' | 'TIMESTAMP' | 'DATE' | 'MONEY' | 'OPTION_STRING', required — The type of the custom field data.
        - `data` string, enum, nullable — The data of the custom field.
      - object — Base class for custom field values
        - `value_type` 'SINGLE_VALUE' | 'LIST', required — The type of the custom field value.
        - `data_type` 'STRING' | 'DECIMAL' | 'BOOLEAN' | 'ENUM' | 'TIMESTAMP' | 'DATE' | 'MONEY' | 'OPTION_STRING', required — The type of the custom field data.
        - `data` string, date-time, nullable — The data of the custom field.
      - object — Base class for custom field values
        - `value_type` 'SINGLE_VALUE' | 'LIST', required — The type of the custom field value.
        - `data_type` 'STRING' | 'DECIMAL' | 'BOOLEAN' | 'ENUM' | 'TIMESTAMP' | 'DATE' | 'MONEY' | 'OPTION_STRING', required — The type of the custom field data.
        - `data` string, date, nullable — The data of the custom field.
      - object — Base class for custom field values
        - `value_type` 'SINGLE_VALUE' | 'LIST', required — The type of the custom field value.
        - `data_type` 'STRING' | 'DECIMAL' | 'BOOLEAN' | 'ENUM' | 'TIMESTAMP' | 'DATE' | 'MONEY' | 'OPTION_STRING', required — The type of the custom field data.
        - `data` object, nullable — The data of the custom field.
          - `amount` integer, required — The amount of money, in the smallest denomination of the currency indicated by currency. For example, when currency is USD, amount is in cents.
          - `currency` string, nullable — The type of currency, in ISO 4217 format.
      - object — Base class for custom field values
        - `value_type` 'SINGLE_VALUE' | 'LIST', required — The type of the custom field value.
        - `data_type` 'STRING' | 'DECIMAL' | 'BOOLEAN' | 'ENUM' | 'TIMESTAMP' | 'DATE' | 'MONEY' | 'OPTION_STRING', required — The type of the custom field data.
        - `data` object, nullable — The data of the custom field.
          - `option_id` string, nullable — The identifier when custom field data is of type option string.
          - `option_label` string, nullable — The label when custom field data is of type option string.
      - object — Base class for custom field values
        - `value_type` 'SINGLE_VALUE' | 'LIST', required — The type of the custom field value.
        - `data_type` 'STRING' | 'DECIMAL' | 'BOOLEAN' | 'ENUM' | 'TIMESTAMP' | 'DATE' | 'MONEY' | 'OPTION_STRING', required — The type of the custom field data.
        - `data` string[], nullable
      - object — Base class for custom field values
        - `value_type` 'SINGLE_VALUE' | 'LIST', required — The type of the custom field value.
        - `data_type` 'STRING' | 'DECIMAL' | 'BOOLEAN' | 'ENUM' | 'TIMESTAMP' | 'DATE' | 'MONEY' | 'OPTION_STRING', required — The type of the custom field data.
        - `data` number[], nullable
      - object — Base class for custom field values
        - `value_type` 'SINGLE_VALUE' | 'LIST', required — The type of the custom field value.
        - `data_type` 'STRING' | 'DECIMAL' | 'BOOLEAN' | 'ENUM' | 'TIMESTAMP' | 'DATE' | 'MONEY' | 'OPTION_STRING', required — The type of the custom field data.
        - `data` boolean[], nullable
      - object — Base class for custom field values
        - `value_type` 'SINGLE_VALUE' | 'LIST', required — The type of the custom field value.
        - `data_type` 'STRING' | 'DECIMAL' | 'BOOLEAN' | 'ENUM' | 'TIMESTAMP' | 'DATE' | 'MONEY' | 'OPTION_STRING', required — The type of the custom field data.
        - `data` string[], nullable
      - object — Base class for custom field values
        - `value_type` 'SINGLE_VALUE' | 'LIST', required — The type of the custom field value.
        - `data_type` 'STRING' | 'DECIMAL' | 'BOOLEAN' | 'ENUM' | 'TIMESTAMP' | 'DATE' | 'MONEY' | 'OPTION_STRING', required — The type of the custom field data.
        - `data` string[], nullable
      - object — Base class for custom field values
        - `value_type` 'SINGLE_VALUE' | 'LIST', required — The type of the custom field value.
        - `data_type` 'STRING' | 'DECIMAL' | 'BOOLEAN' | 'ENUM' | 'TIMESTAMP' | 'DATE' | 'MONEY' | 'OPTION_STRING', required — The type of the custom field data.
        - `data` string[], nullable
      - object — Base class for custom field values
        - `value_type` 'SINGLE_VALUE' | 'LIST', required — The type of the custom field value.
        - `data_type` 'STRING' | 'DECIMAL' | 'BOOLEAN' | 'ENUM' | 'TIMESTAMP' | 'DATE' | 'MONEY' | 'OPTION_STRING', required — The type of the custom field data.
        - `data` Money[], nullable
          - `amount` integer, required — The amount of money, in the smallest denomination of the currency indicated by currency. For example, when currency is USD, amount is in cents.
          - `currency` string, nullable — The type of currency, in ISO 4217 format.
      - object — Base class for custom field values
        - `value_type` 'SINGLE_VALUE' | 'LIST', required — The type of the custom field value.
        - `data_type` 'STRING' | 'DECIMAL' | 'BOOLEAN' | 'ENUM' | 'TIMESTAMP' | 'DATE' | 'MONEY' | 'OPTION_STRING', required — The type of the custom field data.
        - `data` OptionString[], nullable
          - `option_id` string, nullable — The identifier when custom field data is of type option string.
          - `option_label` string, nullable — The label when custom field data is of type option string.

## 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/revisions/3392373807f9/schema)