Resource
Vehicles
Cars in your fleet. Sync vehicle metadata, list availability, or wire your own intake forms to add new units.
The vehicle object
idstring (uuid) | Unique identifier. |
objectstring | Always `"vehicle"`. |
namestring | Display name (e.g. "2024 Tesla Model Y"). |
makestring | Manufacturer. |
modelstring | Model. |
yearinteger | Model year. |
colorstring | Exterior color. |
platestring | License plate. |
transponder_numberstring | EZPass / toll transponder. |
turo_listing_idstring | Turo listing ID for channel sync. |
daily_ratenumber | Daily rental rate, in `currency`. |
deposit_amountnumber | Security deposit, in `currency`. |
statusstring | One of `available`, `rented`, `maintenance`, `unavailable`. |
organization_idstring (uuid) | Owning org. |
Webhook events
Subscribe to receive notifications when vehicle resources change:
vehicle.createdvehicle.updatedEndpoints
GET
/v1/vehiclesscope: readList vehicles
Returns a paginated list of vehicles in your organization.
Query parameters
limitinteger | Default 20. Max 100. |
starting_afterstring | Cursor for pagination. |
Request
curl -X GET 'https://userenvo.com/api/v1/vehicles' \
-H 'Authorization: Bearer rv_live_…'Response
{
"object": "list",
"has_more": false,
"next_cursor": null,
"data": [
{
"object": "vehicle",
"id": "a4d2e1c0-9b…",
"name": "2024 Tesla Model Y",
"make": "Tesla",
"model": "Model Y",
"year": 2024,
"plate": "ABC1234",
"daily_rate": 150,
"status": "available"
}
]
}GET
/v1/vehicles/{id}scope: readRetrieve a vehicle
Path parameters
idrequiredstring | Vehicle id. |
Request
curl -X GET 'https://userenvo.com/api/v1/vehicles/a4d2e1c0-9b…' \
-H 'Authorization: Bearer rv_live_…'Response
{
"object": "vehicle",
"id": "a4d2e1c0-9b…",
"name": "2024 Tesla Model Y",
"daily_rate": 150
}POST
/v1/vehiclesscope: read_writeCreate a vehicle
Body parameters
namerequiredstring | Display name. |
makestring | Manufacturer. |
modelstring | Model. |
yearinteger | Model year. |
platestring | License plate. |
daily_ratenumber | Daily rate in your default currency. |
transponder_numberstring | EZPass tag number. |
Request
curl -X POST 'https://userenvo.com/api/v1/vehicles' \
-H 'Authorization: Bearer rv_live_…' \
-H 'Content-Type: application/json' \
-d '{
"name": "<name>",
"make": "<make>",
"model": "<model>"
}'Response
{
"object": "vehicle",
"id": "a4d2e1c0-9b…",
"name": "2024 Tesla Model Y"
}PATCH
/v1/vehicles/{id}scope: read_writeUpdate a vehicle
Path parameters
idrequiredstring | Vehicle id. |
Body parameters
statusstring | New status. |
daily_ratenumber | New daily rate. |
Request
curl -X PATCH 'https://userenvo.com/api/v1/vehicles/a4d2e1c0-9b…' \
-H 'Authorization: Bearer rv_live_…' \
-H 'Content-Type: application/json' \
-d '{
"status": "<status>",
"daily_rate": 100
}'Response
{
"object": "vehicle",
"id": "a4d2e1c0-9b…",
"status": "maintenance"
}