Skip to content

Ramp: Trips schemas

5 Ramp schemas with complete fields and constraints.

← Trips operations · All schemas

Fetch a trip — response body

FieldTypePresenceDescription and constraints
$objectRoot
created_atstringRequired within parentThe date the trip was created
Format: date-time
descriptionJSONRequired within parent
description (anyOf 1)stringAlternativeThe description for the trip
description (anyOf 2)nullAlternative
end_datestringRequired within parentThe date the trip ends
Format: date-time
idstringRequired within parentUnique identifier for the trip
Format: uuid
length_in_daysJSONRequired within parent
length_in_days (anyOf 1)integerAlternativeNumber of days for the trip
length_in_days (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
locationsarrayRequired within parentDestinations and location segments for the trip
locations[]ModelEach itemExpand Fetch a trip — response body — locations item
namestringRequired within parentThe name of the trip
spend_eventsarrayRequired within parentSpend events for the trip
spend_events[]ModelEach itemExpand Fetch a trip — response body — spend events item
start_datestringRequired within parentThe date the trip starts
Format: date-time
statusstringRequired within parentCurrent trip status
Known values: cancelled, completed, ongoing, upcoming
total_spendJSONRequired within parent
total_spend (anyOf 1)numberAlternativeTotal spend for the trip. Deprecated: use `total_spend_amount` instead.
Read only: true
total_spend (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
total_spend_amountJSONRequired within parent
total_spend_amount (anyOf 1)ModelAlternativeExpand Fetch a transaction — response body — entity amount currency, value
Total spend for the trip in minor units with an explicit ISO 4217 currency code. May be negative for refund-dominated trips. `null` when the trip has no spend events or its spend events do not share a single recognized currency.
Read only: true
total_spend_amount (anyOf 2)nullAlternative
travel_typesarrayRequired within parentTypes of travel for this trip (flights, hotels, cars)
Read only: true
travel_types[]stringEach itemKnown values: CAR, FLIGHT, HOTEL
updated_atstringRequired within parentThe date the trip was last updated
Format: date-time
user_idstringRequired within parentUser/traveler's ID
Format: uuid

Referenced models: Fetch a transaction — response body — entity amount currency, value, Fetch a trip — response body — locations item, Fetch a trip — response body — spend events item

Fetch a trip — response body — locations item

FieldTypePresenceDescription and constraints
$objectRoot
end_datestringRequired within parentThe date the trip segment ends
Format: date-time
locationModelRequired within parentExpand Fetch a trip — response body — locations item location
The location of the trip segment
start_datestringRequired within parentThe date the trip segment starts
Format: date-time

Referenced models: Fetch a trip — response body — locations item location

Fetch a trip — response body — locations item location

FieldTypePresenceDescription and constraints
$objectRoot
cityJSONRequired within parent
city (anyOf 1)stringAlternative
city (anyOf 2)nullAlternative
countryJSONRequired within parent
country (anyOf 1)stringAlternative
country (anyOf 2)nullAlternative
latitudeJSONRequired within parent
latitude (anyOf 1)JSONAlternative
latitude (anyOf 1) (anyOf 1)numberAlternative
latitude (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
latitude (anyOf 2)nullAlternative
longitudeJSONRequired within parent
longitude (anyOf 1)JSONAlternative
longitude (anyOf 1) (anyOf 1)numberAlternative
longitude (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
longitude (anyOf 2)nullAlternative
stateJSONRequired within parent
state (anyOf 1)stringAlternative
state (anyOf 2)nullAlternative

Fetch a trip — response body — spend events item

FieldTypePresenceDescription and constraints
$objectRoot
idstringRequired within parentThe ID of the spend event
Format: uuid
Read only: true
spend_typestringRequired within parentThe type of the spend event
Known values: BILL, REIMBURSEMENT, TRANSACTION

List all trips for the business — response body

FieldTypePresenceDescription and constraints
$objectRoot
dataarrayRequired within parentResources returned in this page.
data[]arrayEach item
data[][]ModelEach itemExpand Fetch a trip — response body
pageModelRequired within parentExpand List bills — response body — page
Pagination details for this response.

Referenced models: List bills — response body — page, Fetch a trip — response body

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.