Skip to main content
GET
Get a vehicle search item
Open a vehicle of the search results to see what the list only summarizes: its specifications and every fare option. To book it, create a trip with the item’s id as searchItemId and the chosen fareOptions entry’s id as fareId. Amounts are integers in cents: 98700 is R$ 987,00. The item lives as long as its search (see ttl). An error the travel provider reports about the request is returned with its own status, code and message.

Path Parameters

realmId
string<uuid>
required

ID of your realm.

Format: UUID

organizationId
string<uuid>
required

ID of your organization.

Format: UUID

searchId
string
required

ID of the search, as returned when it was created.

Pattern: ^srch_[0-9A-Za-z]{21}$
itemId
string
required

ID of the item to load, as listed in the items of the search results.

Pattern: ^srch_item_[0-9A-Za-z]{21}$

Response

Successful response

The detail of one vehicle of a vehicle search: the vehicle and every fare option.

id
string
required

ID of the item. Send it as searchItemId when you create a trip.

Example:

"srch_item_Rn2Xd8GuYc4Wv6ZkJe1Ta"

searchId
string
required

ID of the search the item belongs to.

Example:

"srch_Hb7Yk1DrMv3Lq8UsAe0Xj"

groupName
string
required

Name of the group of vehicles that fulfil the same booking class.

Example:

"Economy"

class
string
required

Class of the vehicle.

Example:

"Economy"

name
string
required

Commercial name of the vehicle.

Example:

"Fiat Mobi"

sipp
string
required

SIPP (ACRISS) code of the vehicle.

Example:

"EDMR"

pickUpLocation
object
required

Where the vehicle is picked up.

dropOffLocation
object
required

Where the vehicle is dropped off.

pickUpDate
string
required

Pick-up, in the local time of the station (YYYY-MM-DDTHH:mm:ss, no time-zone offset).

Example:

"2026-11-02T10:00:00"

dropOffDate
string
required

Drop-off, in the local time of the station (YYYY-MM-DDTHH:mm:ss, no time-zone offset).

Example:

"2026-11-05T10:00:00"

model
string
required

Model of the vehicle.

Example:

"Mobi Like 1.0"

vehicleDetails
object
required

Specifications of the vehicle.

rentalCompany
object
required

Company that rents the vehicle.

mainImage
object
required

Main image of the vehicle.

fareOptions
object[]
required

Every fare option of the vehicle, each with its price, rules and ID — send the chosen one's id as fareId when you create a trip.