---
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

## 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' | 'INVITED' | '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.

## 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/ab632cfd06cf/schema)