List Archived Vehicles
Returns a list of archived vehicles.
Query Parameters
- start_cursor string
The start cursor for Keyset pagination.
- per_page integer
Possible values:
>= 2
and<= 100
Default value:
50
The number of records per page to return
- filter object
The fields, operations, and values to filter the records by.
name object
oneOf- MOD1
- MOD2
like string requiredeq string requiredvin object
oneOf- MOD1
- MOD2
like string requiredeq string requiredlicense_plate object
oneOf- MOD1
- MOD2
like string requiredeq string requiredexternal_id object
like string requiredarchived_at object
oneOf- MOD1
- MOD2
- MOD3
- MOD4
lt string requiredlte string requiredgt string requiredgte string required
- 200
- 400
- 401
- 500
OK
- application/json
- Schema
- Example (from schema)
Schema
- start_cursor string
The current start cursor of the records returned.
- next_cursor string
The next cursor to retrieve the next page of records.
- per_page integer
The maxumum number of records returned.
- estimated_remaining_count integer
The number of remaining records including the returned records, up to a maximum of 500.
filtered_by object[]
The filters applied to the returned record set.
anyOf- MOD1
- MOD2
- MOD3
- MOD4
- MOD5
name object
oneOf- MOD1
- MOD2
like stringeq stringvin object
oneOf- MOD1
- MOD2
like stringeq stringlicense_plate object
oneOf- MOD1
- MOD2
like stringeq stringexternal_id object
eq stringarchived_at object
oneOf- MOD1
- MOD2
- MOD3
- MOD4
lt stringlte stringgt stringgte stringsorted_by object[]
The sorts applied to the returned record set.
anyOf- MOD1
- MOD2
archived_at stringPossible values: [
asc
,desc
]id stringPossible values: [
asc
,desc
]records object[]
id integeraccount_id integerarchived_at date-timeThe iso8601 date and time at which the vehicle was archived, for an archived vehicle.
fuel_type_id integerfuel_type_name stringThe name of the
Fuel Type
associated with this vehicle.fuel_volume_units VolumeUnitPossible values: [
us_gallons
,uk_gallons
,liters
]group_id integergroup_name stringThe name of the
Group
associated with this vehicle, for vehicles associated with a group.name stringThis vehicle's name.
ownership VehicleOwnershipResponsePossible values: [
Owned
,Leased
,Rented
,Customer
]current_location_entry_id integersystem_of_measurement MeasurementSystemPossible values: [
imperial
,metric
]vehicle_type_id integerThis vehicles
Vehicle Type
id.vehicle_type_name stringThe name of the
Vehicle Type
associated with this Vehicle.is_sample booleanIndicates whether this Vehicle record is Sample Data.
vehicle_status_id integerThe id of the
Vehicle Status
of this vehicle.vehicle_status_name stringThe name of the
Vehicle Status
associated with this Vehicle.vehicle_status_color stringThe hex color code of the
Vehicle Status
associated with this Vehicle.primary_meter_unit MeterUnitPossible values: [
km
,hr
,mi
]The measurement unit used for the Vehicle's primary, or secondary (if applicable), meter.
primary_meter_value stringThe current value of the primary meter for this Vehicle.
primary_meter_date date-timeThe date and time at which the primary meter was last updated.
primary_meter_usage_per_day stringThe average number of units of the primary meter used per day.
secondary_meter_unit MeterUnitPossible values: [
km
,hr
,mi
]The measurement unit used for the Vehicle's primary, or secondary (if applicable), meter.
secondary_meter_value stringThe current value of the secondary meter for this Vehicle.
secondary_meter_date date-timeThe date and time at which the secondary meter was last updated.
secondary_meter_usage_per_day stringThe average number of units of the secondary meter used per day.
in_service_meter_value stringThe meter value at which this Vehicle was put into service.
in_service_date date-timeThe date on which this Vehicle was put into service.
out_of_service_meter_value stringThe meter value at which this Vehicle was or will be retired.
out_of_service_date date-timeThe date on which this Vehicle was or will be retired.
estimated_service_months integerThe estimated number of months this Vehicle will be in service.
estimated_replacement_mileage stringThe estimated number of miles before which this Vehicle will be replaced.
estimated_resale_price_cents integerThe estimated resale price of this Vehicle in cents.
fuel_entries_count integerThe number of
Fuel Entries
associated with this Vehicle.service_entries_count integerThe number of
Service Entries
associated with this Vehicle.service_reminders_count integerThe number of
Service Reminders
associated with this Vehicle.vehicle_renewal_reminders_count integerThe number of
Vehicle Renewal Reminders
associated with this Vehicle.comments_count integerThe number of
Comments
associated with this Vehicle.documents_count integerThe number of documents attached to this Vehicle.
images_count integerThe number of images attached to this Vehicle.
issues_count integerThe number of
Issues
this Vehicle is associated with.work_orders_count integerThe number of
Work Orders
this Vehicle is associated with.labels object[]
id integerPossible values:
>= 1
name stringgroup_ancestry stringThe ancestry of the Group associated with this Vehicle.
color stringThe color of this Vehicle.
license_plate stringThe license plate number of this Vehicle.
vin stringThe Vehicle Identification Number of this Vehicle.
year stringThis Vehicle's model year.
make stringThe name of this Vehicle's manufacturer.
model stringThe name of the model of this Vehicle.
trim stringThe trim level of this Vehicle.
registration_expiration_month integerPossible values:
<= 12
The month in which this Vehicle's registration expires.
registration_state stringThe state, province, or territory in which this Vehicle is registered.
default_image_url_small stringThe URL of a small-sized version of the default image for this Vehicle.
external_ids objectAny External IDs associated with this Vehicle.
ai_enabled booleanWhether this Vehicle has Auto Integrate enabled for it.
assetable_type stringPossible values: [
Vehicle
]Assetable type for Vehicle is always
Vehicle
for vehicles.custom_fields object*Full details on working with Custom Fields here.
axle_config_id integerThe id of the
Axle Configuration
of this vehicle.
{
"start_cursor": "string",
"next_cursor": "string",
"per_page": 0,
"estimated_remaining_count": 0,
"filtered_by": [
{
"name": {
"like": "string"
}
},
{
"vin": {
"like": "string"
}
},
{
"license_plate": {
"like": "string"
}
},
{
"external_id": {
"eq": "string"
}
},
{
"archived_at": {
"lt": "string"
}
}
],
"sorted_by": [
{
"archived_at": "asc"
},
{
"id": "asc"
}
],
"records": [
{
"id": 0,
"account_id": 0,
"archived_at": "2023-03-14T13:46:27-06:00",
"fuel_type_id": 0,
"fuel_type_name": "string",
"fuel_volume_units": "us_gallons",
"group_id": 0,
"group_name": "string",
"name": "string",
"ownership": "Owned",
"current_location_entry_id": 0,
"system_of_measurement": "imperial",
"vehicle_type_id": 0,
"vehicle_type_name": "string",
"is_sample": true,
"vehicle_status_id": 0,
"vehicle_status_name": "string",
"vehicle_status_color": "string",
"primary_meter_unit": "km",
"primary_meter_value": "string",
"primary_meter_date": "2023-03-14T13:46:27-06:00",
"primary_meter_usage_per_day": "string",
"secondary_meter_unit": "km",
"secondary_meter_value": "string",
"secondary_meter_date": "2023-03-14T13:46:27-06:00",
"secondary_meter_usage_per_day": "string",
"in_service_meter_value": "string",
"in_service_date": "2023-03-14T13:46:27-06:00",
"out_of_service_meter_value": "string",
"out_of_service_date": "2023-03-14T13:46:27-06:00",
"estimated_service_months": 0,
"estimated_replacement_mileage": "string",
"estimated_resale_price_cents": 0,
"fuel_entries_count": 0,
"service_entries_count": 0,
"service_reminders_count": 0,
"vehicle_renewal_reminders_count": 0,
"comments_count": 0,
"documents_count": 0,
"images_count": 0,
"issues_count": 0,
"work_orders_count": 0,
"labels": [
{
"id": 0,
"name": "string"
}
],
"group_ancestry": "string",
"color": "string",
"license_plate": "string",
"vin": "string",
"year": "string",
"make": "string",
"model": "string",
"trim": "string",
"registration_expiration_month": 0,
"registration_state": "string",
"default_image_url_small": "string",
"external_ids": {},
"ai_enabled": true,
"assetable_type": "Vehicle",
"custom_fields": {},
"axle_config_id": 0
}
]
}
The format or parameters of the request was invalid
- application/json
- Schema
- Example (from schema)
Schema
errors object
typeitems string
{
"errors": {}
}
Request could not be authenticated
- application/json
- Schema
- Example (from schema)
Schema
- status integer
Possible values:
>= 400
and<= 599
- title string
A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.
- detail string
A human-readable explanation specific to this occurrence of the problem.
- instance string
A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
{
"status": 0,
"title": "string",
"detail": "string",
"instance": "string"
}
Something unexpected happened
- application/json
- Schema
- Example (from schema)
Schema
- status integer
Possible values:
>= 400
and<= 599
- title string
A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.
- detail string
A human-readable explanation specific to this occurrence of the problem.
- instance string
A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
{
"status": 0,
"title": "string",
"detail": "string",
"instance": "string"
}