Skip to main content
POST
/
v0
/
business
/
{business_id}
/
trips
Create one or more trips (max 100)
curl --request POST \
  --url https://api.sandbox.getasset.com/v0/business/{business_id}/trips \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "vehicle_id": "<string>",
    "trip_date": "2023-12-25",
    "distance": "42.50",
    "external_id": "1234567890",
    "purpose": "personal",
    "start_address": "123 Main St, San Francisco, CA",
    "end_address": "456 Market St, San Francisco, CA",
    "notes": "Client lunch meeting"
  }
]
'
{
  "data": [
    {
      "business_id": "<string>",
      "vehicle_id": "<string>",
      "trip_date": "2023-12-25",
      "distance": 123,
      "start_address": "123 Main St, San Francisco, CA",
      "end_address": "456 Market St, San Francisco, CA",
      "id": "<string>",
      "external_id": "1234567890",
      "notes": "Client lunch meeting",
      "purpose": "personal",
      "amount": 7.25,
      "amount_reason": "Standard rate applied"
    }
  ],
  "errors": [
    {
      "error": "<string>",
      "external_id": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

business_id
string<biz_string>
required

Body

application/json
Maximum array length: 100
vehicle_id
string<vhc_string>
required

The id of the Vehicle used for the trip

Example:

"vhc_GA6EG2qFxA97NZHtxeLPUy"

trip_date
string<date>
required

The date the trip occurred

Example:

"2026-04-22"

distance
required

The distance travelled, in units defined by distance_unit

Required range: x > 0
Example:

"42.50"

distance_unit
enum<string>
required

The unit of measurement for distance

Available options:
miles,
kilometers
Example:

"miles"

external_id
string | null

The external ID of the Trip

Maximum string length: 255
Example:

"1234567890"

purpose
enum<string> | null

Whether the trip was for business or personal use

Available options:
business,
personal
Example:

"personal"

start_address
string | null

Where the trip started (unstructured)

Maximum string length: 500
Example:

"123 Main St, San Francisco, CA"

end_address
string | null

Where the trip ended (unstructured)

Maximum string length: 500
Example:

"456 Market St, San Francisco, CA"

notes
string | null

Free-form notes about the trip from the user

Maximum string length: 1000
Example:

"Client lunch meeting"

Response

Successful Response

data
TripPublic · object[]
required
errors
TripCreateError · object[]
required