Skip to main content

Retrieve Equipment

GET 

https://secure.fleetio.com/api/v1/equipment/:id

Retrieve the details of an existing Equipment.

Request

Path Parameters

    id stringrequired

    Possible values: Value must match regular expression ^[0-9]+$

    The id of the relevant record

Responses

OK

Schema
    idId (integer)required

    Possible values: >= 1

    created_atdate-timerequired

    The date and time at which this record was created.

    Example: 2023-03-14T13:46:27-06:00
    updated_atdate-timerequired

    The date and time at which this record was most recently updated.

    Example: 2023-03-14T13:46:27-06:00
    namestringrequired

    The name for this Equipment.

    brandstringnullablerequired

    The name of the brand which makes this Equipment.

    modelstringnullablerequired

    The model name of this Equipment.

    serial_numberstringnullablerequired

    The serial number of this Equipment.

    equipment_type_idId (integer)required

    Possible values: >= 1

    type_namestringrequired

    The name of the associated Equipment Type.

    equipment_status_idId (integer)required

    Possible values: >= 1

    status_namestringrequired

    The name of the associated Equipment Status.

    group_idNullableId (integer)nullablerequired

    Possible values: >= 1

    group_namestringnullablerequired

    The name of the associated Group.

    purchase_vendor_idNullableId (integer)nullablerequired

    Possible values: >= 1

    purchase_price_centsintegernullablerequired

    The purchase price in cents.

    purchase_datedatenullablerequired

    The date on which the Equipment was purchased.

    Example: 2023-03-14
    estimated_resale_pricefloatnullablerequired

    The estimated resale price of this Equipment.

    warranty_expiration_datedatenullablerequired

    The date on which the Equipment warranty expires.

    Example: 2023-03-14
    purchase_commentsstringnullablerequired

    Any comments about the purchase of this Equipment.

    custom_fieldsobjectnullable

    *Full details on working with Custom Fields here.

    in_service_datedatenullablerequired

    The date on which the Equipment was put into service.

    Example: 2023-03-14
    estimated_service_lifeintegernullablerequired

    The estimated duration in months of the service life for this Equipment.

    out_of_service_datedatenullablerequired

    The estimated date on which the Equipment will be retired from service.

    Example: 2023-03-14
    archived_atdate-timenullablerequired

    The date and time at which the Equipment was archived.

    status_colorstringnullablerequired

    The color of the associated Equipment Status.

    linked_vehicle objectnullablerequired

    A Vehicle

    idinteger
    created_atdate-time
    updated_atdate-time
    account_idId (integer)

    Possible values: >= 1

    archived_atdate-timenullable

    The date and time at which the Vehicle was archived.

    Example: 2023-03-14T13:46:27-06:00
    fuel_type_idNullableId (integer)nullable

    Possible values: >= 1

    fuel_type_namestringnullable

    The name of the Fuel Type associated with this Vehicle.

    fuel_volume_unitsVolumeUnit (string)

    Possible values: [us_gallons, uk_gallons, liters]

    group_idNullableId (integer)nullable

    Possible values: >= 1

    group_namestringnullable

    The name of the Group associated with this Vehicle.

    meter_unitMeterUnit (string)nullable

    The measurement unit used for the Vehicle's primary, or secondary (if applicable), meter.

    Possible values: [km, hr, mi]

    namestring

    This Vehicle's name.

    ownershipVehicleOwnershipResponse (string)

    Possible values: [Owned, Leased, Rented, Customer]

    secondary_meterboolean

    Indicates whether or not this Vehicle has a secondary meter.

    secondary_meter_unitMeterUnit (string)nullable

    The measurement unit used for the Vehicle's primary, or secondary (if applicable), meter.

    Possible values: [km, hr, mi]

    system_of_measurementMeasurementSystem (string)

    Possible values: [imperial, metric]

    labels object[]

    The Labels associated with this Vehicle. Available by passing the expand=labels query parameter.

  • Array [
  • idId (integer)

    Possible values: >= 1

    namestring

    The name of the Label. This is the value used to tag a record.

    colorstring

    The hex color of the Label.

    Example: #44DB38
  • ]
  • vehicle_status_idId (integer)

    Possible values: >= 1

    vehicle_status_namestring

    The name of the Vehicle Status associated with this Vehicle.

    vehicle_status_colorstringnullable

    The color of the Vehicle Status associated with this Vehicle.

    vehicle_type_idId (integer)

    Possible values: >= 1

    vehicle_type_namestring

    The name of the Vehicle Type associated with this Vehicle.

    fuel_entries_countinteger

    The number of Fuel Entries associated with this Vehicle.

    Possible values: >= 0

    service_entries_countinteger

    The number of Service Entries associated with this Vehicle.

    Possible values: >= 0

    service_reminders_countinteger

    The number of Service Reminders associated with this Vehicle.

    Possible values: >= 0

    vehicle_renewal_reminders_countinteger

    The number of Vehicle Renewal Reminders associated with this Vehicle.

    Possible values: >= 0

    comments_countinteger

    The number of Comments associated with this Vehicle.

    Possible values: >= 0

    documents_countinteger

    The number of documents attached to this Vehicle.

    Possible values: >= 0

    images_countinteger

    The number of images attached to this Vehicle.

    Possible values: >= 0

    current_location_entry_idNullableId (integer)nullable

    Possible values: >= 1

    is_sampleboolean

    Indicates whether this Vehicle record is Sample Data.

    in_service_datedate-timenullable

    The date on which this Vehicle was put into service.

    Example: 2023-03-14T13:46:27-06:00
    in_service_meterfloatnullable

    The meter value at which this Vehicle was put into service.

    estimated_service_monthsintegernullable

    The estimated number of months this Vehicle will be in service.

    estimated_replacement_mileagestringnullable

    The estimated number of miles before which this Vehicle will be replaced.

    estimated_resale_price objectnullable

    The estimated resale price of this Vehicle.

    centsinteger

    The estimated resale price of this Vehicle in cents.

    Possible values: >= 0

    currency_isostring

    The ISO 4217 currency code of the estimated resale price.

    out_of_service_datedate-timenullable

    The date on which this Vehicle was or will be retired.

    Example: 2023-03-14T13:46:27-06:00
    out_of_service_meterfloatnullable

    The meter value at which this Vehicle was or will be retired.

    meter_namestring

    The name of the primary meter for this Vehicle.

    secondary_meter_namestring

    The name of the secondary meter for this Vehicle.

    primary_meter_usage_per_daystringnullable

    The average number of units of the primary meter used per day.

    secondary_meter_usage_per_daystringnullable

    The average number of units of the secondary meter used per day.

    current_meter_valuefloatnullable

    The current value of the primary meter for this Vehicle.

    current_meter_datedate-timenullable

    The date and time at which the primary meter was last updated.

    Example: 2023-03-14T13:46:27-06:00
    secondary_meter_valuefloatnullable

    The current value of the secondary meter for this Vehicle.

    secondary_meter_datedate-timenullable

    The date and time at which the secondary meter was last updated.

    Example: 2023-03-14T13:46:27-06:00
    group_ancestrystringnullable

    The ancestry of the Group associated with this Vehicle.

    colorstringnullable

    The color of this Vehicle.

    license_platestringnullable

    The license plate number of this Vehicle.

    vinstringnullable

    The Vehicle Identification Number of this Vehicle.

    yearstringnullable

    This Vehicle's model year.

    makestringnullable

    The name of this Vehicle's manufacturer.

    modelstringnullable

    The name of the model of this Vehicle.

    trimstringnullable

    The trim level of this Vehicle.

    registration_expiration_monthintegernullable

    The month in which this Vehicle's registration expires.

    Possible values: >= 0 and <= 12

    registration_statestringnullable

    The state, province, or territory in which this Vehicle is registered.

    loan_account_numberstringnullable

    The account number for this Vehicle's loan, if applicable.

    loan_ended_atdate-timenullable

    The date and time at which this Vehicle's loan ends.

    Example: 2023-03-14T13:46:27-06:00
    loan_interest_ratefloatnullable

    The interest rate for this Vehicle's loan.

    loan_notesstringnullable

    Notes about this Vehicle's loan.

    loan_started_atdate-timenullable

    The date and time at which this Vehicle's loan began. Formatted according to ISO-8601 in User's local time.

    Example: 2023-03-14T13:46:27-06:00
    loan_vendor_idNullableId (integer)nullable

    Possible values: >= 1

    loan_vendor_namestringnullable

    The name of the Vendor for this Vehicle's loan.

    custom_fieldsobjectnullable

    *Full details on working with Custom Fields here.

    inspection_schedules_countinteger

    The number of inspection schedules this Vehicle is associated with.

    Possible values: >= 0

    issues_countinteger

    The number of Issues this Vehicle is associated with.

    Possible values: >= 0

    work_orders_countinteger

    The number of Work Orders this Vehicle is associated with.

    Possible values: >= 0

    type_namestringnullable

    The name of the Vehicle Type associated with this Vehicle.

    default_image_urlstringnullable

    The URL of the default image for this Vehicle.

    default_image_url_mediumstringnullable

    The URL of a medium-sized version of the default image for this Vehicle.

    default_image_url_smallstringnullable

    The URL of a small-sized version of the default image for this Vehicle.

    default_image_url_largestringnullable

    The URL of a large-sized version of the default image for this Vehicle.

    specs object
    idId (integer)

    Possible values: >= 1

    vehicle_idinteger

    The Vehicle ID these specs belong to.

    account_idinteger
    body_typestringnullable

    The body type of the Vehicle, if available.

    body_subtypestringnullable

    The subtype of the Vehicle body, if available.

    drive_typestringnullable

    The drive type of the Vehicle, if available.

    brake_systemstringnullable

    The brake system used in the Vehicle, if available.

    msrp_centsintegernullable

    The Manufacturer's Suggested Retail Price (MSRP) in cents, if available.

    fuel_tank_capacityfloatnullable

    The fuel tank capacity of the Vehicle, if available.

    fuel_tank_2_capacityfloatnullable

    The capacity of a second fuel tank, if available.

    front_track_widthfloatnullable

    The front track width of the Vehicle, if available.

    ground_clearancefloatnullable

    The ground clearance of the Vehicle, if available.

    heightfloatnullable

    The height of the Vehicle, if available.

    lengthfloatnullable

    The length of the Vehicle, if available.

    rear_track_widthfloatnullable

    The rear track width of the Vehicle, if available.

    widthfloatnullable

    The width of the Vehicle, if available.

    wheelbasefloatnullable

    The wheelbase of the Vehicle, if available.

    front_tire_psistringnullable

    The recommended PSI for front tires, if available.

    rear_tire_psistringnullable

    The recommended PSI for rear tires, if available.

    base_towing_capacitystringnullable

    The base towing capacity of the Vehicle, if available.

    curb_weightfloatnullable

    The curb weight of the Vehicle, if available.

    gross_vehicle_weight_ratingfloatnullable

    The Gross Vehicle Weight Rating (GVWR), if available.

    bed_lengthstringnullable

    The length of the Vehicle's bed, if available.

    max_payloadstringnullable

    The maximum payload capacity of the Vehicle, if available.

    rear_axle_typestring

    The type of rear axle used in the Vehicle.

    front_tire_typestring

    The type of front tires used in the Vehicle.

    front_wheel_diameterstring

    The diameter of the front wheels.

    rear_tire_typestring

    The type of rear tires used in the Vehicle.

    rear_wheel_diameterstring

    The diameter of the rear wheels.

    epa_cityfloatnullable

    The EPA city fuel economy rating, if available.

    epa_highwayfloatnullable

    The EPA highway fuel economy rating, if available.

    epa_combinedfloatnullable

    The combined EPA fuel economy rating, if available.

    engine_descriptionstring

    Description of the Vehicle's engine.

    engine_brandstring

    Brand of the Vehicle's engine.

    engine_aspirationstringnullable

    Aspiration type of the engine, if available.

    engine_block_typestringnullable

    Block type of the engine, if available.

    engine_borestringnullable

    Bore size of the engine, if available.

    engine_cam_typestringnullable

    Camshaft type of the engine, if available.

    engine_compressionstringnullable

    Compression ratio of the engine, if available.

    engine_cylindersintegernullable

    Number of engine cylinders, if available.

    engine_displacementstringnullable

    Engine displacement, if available.

    fuel_inductionstringnullable

    Fuel induction method, if available.

    fuel_qualitystring

    Fuel quality required for the engine.

    max_hpstringnullable

    Maximum horsepower produced by the engine, if available.

    max_torquestringnullable

    Maximum torque produced by the engine, if available.

    oil_capacitystringnullable

    Oil capacity of the engine, if available.

    redline_rpmstring

    Redline RPM of the engine.

    engine_strokestringnullable

    Stroke length of the engine, if available.

    engine_valvesintegernullable

    Number of engine valves, if available.

    transmission_descriptionstring

    Description of the Vehicle's transmission.

    transmission_brandstring

    Brand of the Vehicle's transmission.

    transmission_typestringnullable

    Type of transmission, if available.

    transmission_gearsintegernullable

    Number of gears in the transmission, if available.

    cargo_volumefloatnullable

    Cargo volume of the Vehicle, if available.

    interior_volumefloatnullable

    Interior volume of the Vehicle, if available.

    passenger_volumestring

    Passenger volume of the Vehicle.

    created_atdate-time

    The date and time when the specs were created.

    updated_atdate-time

    The date and time when the specs were last updated.

    duty_typestringnullable

    Type of duty the Vehicle is designed for, if available.

    weight_classstringnullable

    Weight class of the Vehicle, if available.

    engine_bore_with_unitsstringnullable

    Bore size of the engine with units, if available.

    wheelbase_with_unitsstringnullable

    Wheelbase of the Vehicle with units, if available.

    msrpstringnullable

    Manufacturer's Suggested Retail Price (MSRP).

    external_idsobject

    Any External IDs associated with this Vehicle.

    ai_enabledboolean

    Whether this Vehicle has Auto Integrate enabled for it.

    assetable_typestring

    Assetable type for Vehicle is always Vehicle for vehicles.

    Possible values: [Vehicle]

    driver object
    idNullableId (integer)nullable

    Possible values: >= 1

    first_namestringnullable

    The first name of the Contact (driver) associated with this Vehicle.

    last_namestringnullable

    The last name of the Contact (driver) associated with this Vehicle.

    full_namestringnullable

    The full name of the Contact (driver) associated with this Vehicle.

    default_image_urlstringnullable

    The URL of the default image of the Contact (driver) associated with this Vehicle.

    current_location_entry objectnullable

    The current location of the associated object.

    idinteger

    The unique identifier for the current Location Entry.

    locatable_typestring

    The type of object that this Location Entry is associated with.

    locatable_idinteger

    The unique identifier of the object that this Location Entry is associated with.

    datedate-time

    The date and time when this Location Entry was recorded.

    created_atdate-time

    The date and time when this Location Entry was created.

    updated_atdate-time

    The date and time when this Location Entry was last updated.

    contact_idinteger

    The unique identifier of the associated Contact.

    addressstring

    The address associated with this Location Entry.

    is_currentboolean

    Indicates whether this Location Entry is the current location.

    item_typestring

    The type of item associated with this Location Entry.

    item_idinteger

    The unique identifier of the item associated with this Location Entry.

    locationstring

    The geographical location in the format "POINT (longitude latitude)".

    address_components object
    street_numberstring

    The street number in the address.

    streetstring

    The street name in the address.

    citystring

    The city in the address.

    regionstring

    The region, state or province in the address.

    region_shortstring

    The abbreviated region, state or province code.

    countrystring

    The country in the address.

    country_shortstring

    The abbreviated country code.

    postal_codestring

    The postal code, ZIP, or equivalent in the address.

    geolocation object
    latitudefloat

    The latitude coordinate of the location.

    longitudefloat

    The longitude coordinate of the location.

    loan_amountfloatnullable

    The amount of this Vehicle's loan.

    loan_paymentfloatnullable

    The amount of this Vehicle's loan payment.

    warranties_active_countinteger

    The number of active warranties associated with this Vehicle.

    Possible values: >= 0

    warranties_countinteger

    The number of warranties associated with this Vehicle.

    Possible values: >= 0

    residual_valuefloatnullable

    The residual value of this Vehicle at the end of its lease.

    axle_config_idintegernullable

    The id of the Axle Configuration of this vehicle.

    assigned_contact objectnullablerequired

    A Contact

    idinteger
    created_atdate-time
    updated_atdate-time
    emailstringnullable

    The Contact's email address.

    namestringnullable

    The Contact's full name.

    first_namestringnullable

    The Contact's first name.

    middle_namestringnullable

    The Contact's middle name.

    last_namestringnullable

    The Contact's last name.

    images_countinteger

    The number of images associated with this Contact.

    Possible values: >= 0

    documents_countinteger

    The number of documents associated with this Contact.

    Possible values: >= 0

    comments_countinteger

    The number of comments associated with this Contact.

    Possible values: >= 0

    group_idintegernullable

    If this Contact belongs to a Group, this will be the Fleetio ID of that Group.

    group_namestringnullable

    If this Contact belongs to a Group, this will be the Group's name.

    group_hierarchystringnullable

    If this Contact belongs to a Group, this will be a pipe delimited string representing the Group hierarchy. Each Group in the list is the parent of the Groups which follow.

    Example: Group 1|Group 2|Group 3
    technicianbooleannullable

    Whether or not the Contact is a Technician.

    vehicle_operatorbooleannullable

    Whether or not the Contact is a Vehicle Operator.

    employeebooleannullable

    Whether or not the Contact is an Employee.

    birth_datedatenullable

    The Contact's birth date.

    Example: 2023-03-14
    street_addressstringnullable

    The Contact's street address.

    Example: 123 Main St
    street_address_line_2stringnullable

    The Contact's street address line 2.

    Example: Apt 1
    citystringnullable

    The Contact's city.

    regionstringnullable

    The Contact's region, state, or province.

    postal_codestringnullable

    The Contact's postal code, zip code, or equivalent.

    countrystringnullable

    The Contact's country.

    employee_numberstringnullable

    The Contact's employee number.

    job_titlestringnullable

    The Contact's job title.

    Possible values: <= 255 characters

    license_classstringnullable

    The Contact's driver's license class.

    license_numberstringnullable

    The Contact's driver's license number.

    license_statestringnullable

    The locality which issued the Contact's license.

    license_expirationdatenullable

    The Contact's driver's license expiration date.

    Example: 2023-03-14
    home_phone_numberstringnullable

    The Contact's home phone number.

    mobile_phone_numberstringnullable

    The Contact's mobile phone number.

    work_phone_numberstringnullable

    The Contact's work phone number.

    other_phone_numberstringnullable

    Any other phone number for this Contact.

    start_datedatenullable

    When the Contact started working for the company, if applicable.

    leave_datedatenullable

    When the Contact left or will leave the company, if applicable.

    hourly_labor_ratefloatnullable

    The Contact's hourly rate.

    custom_fieldsobjectnullable

    *Full details on working with Custom Fields here.

    attachment_permissions objectnullable
    read_photosboolean

    Indicates whether the user has read permission for photos.

    manage_photosboolean

    Indicates whether the user has permission to manage (eg. upload, delete) photos.

    read_documentsboolean

    Indicates whether the user has read permission for documents.

    manage_documentsboolean

    Indicates whether the user has permission to manage (eg. upload, delete) documents.

    default_image_urlstringnullable

    The URL of the Contact's default image/profile photo, if any.

    userobjectnullable

    If the Contact is a Fleetio User, those details will be included here.

    account_membership_idNullableId (integer)nullable

    Possible values: >= 1

    last_api_requestdate-timenullable

    The last date and time this Contact's associated User made an API request. Null if Contact is not assocated with a User.

    last_web_accessdate-timenullable

    The last date and time this Contact's associated User signed into the web application. Null if Contact is not assocated with a User.

    last_mobile_app_accessdate-timenullable

    The last date and time this Contact's associated User used the mobile app. Null if Contact is not assocated with a User.

    attachment_permissions objectnullablerequired
    read_photosboolean

    Indicates whether the user has read permission for photos.

    manage_photosboolean

    Indicates whether the user has permission to manage (eg. upload, delete) photos.

    read_documentsboolean

    Indicates whether the user has read permission for documents.

    manage_documentsboolean

    Indicates whether the user has permission to manage (eg. upload, delete) documents.

    default_image_urlstringnullablerequired

    The URL of the Equipment's default image/profile photo, if any.

    assetable_typestringnullablerequired

    The type of assetable object.

    issues_countintegerrequired

    The number of Issues associated with this Equipment.

    current_location_entry objectnullablerequired

    The current location of the associated object.

    idinteger

    The unique identifier for the current Location Entry.

    locatable_typestring

    The type of object that this Location Entry is associated with.

    locatable_idinteger

    The unique identifier of the object that this Location Entry is associated with.

    datedate-time

    The date and time when this Location Entry was recorded.

    created_atdate-time

    The date and time when this Location Entry was created.

    updated_atdate-time

    The date and time when this Location Entry was last updated.

    contact_idinteger

    The unique identifier of the associated Contact.

    addressstring

    The address associated with this Location Entry.

    is_currentboolean

    Indicates whether this Location Entry is the current location.

    item_typestring

    The type of item associated with this Location Entry.

    item_idinteger

    The unique identifier of the item associated with this Location Entry.

    locationstring

    The geographical location in the format "POINT (longitude latitude)".

    address_components object
    street_numberstring

    The street number in the address.

    streetstring

    The street name in the address.

    citystring

    The city in the address.

    regionstring

    The region, state or province in the address.

    region_shortstring

    The abbreviated region, state or province code.

    countrystring

    The country in the address.

    country_shortstring

    The abbreviated country code.

    postal_codestring

    The postal code, ZIP, or equivalent in the address.

    geolocation object
    latitudefloat

    The latitude coordinate of the location.

    longitudefloat

    The longitude coordinate of the location.

    comments_countintegerrequired

    The number of Comments associated with this Equipment.

    Possible values: >= 0

    documents_countintegerrequired

    The number of documents associated with this Equipment.

    Possible values: >= 0

    images_countintegerrequired

    The number of images associated with this Equipment.

    Possible values: >= 0

    is_watchedbooleanrequired

    Indicates whether this Equipment is being watched.

    Default value: false
    watchers_countintegerrequired

    The number of users watching this Equipment.

    Possible values: >= 0

Authorization: Authorization

name: Authorizationtype: apiKeyin: headerdescription: Prefix the value with "Token", for example: "Token 76cbe06c49a64".
You can generate a new API key [here](https://secure.fleetio.com/api_keys).
name: Account-Tokentype: apiKeyin: headerdescription: You can find your Account-Token [here](https://secure.fleetio.com/api_keys)
curl -L 'https://secure.fleetio.com/api/v1/equipment/:id' \
-H 'Accept: application/json' \
-H 'Authorization: Token <Authorization>' \
-H 'Account-Token: <Authorization>'
Request Collapse all
Base URL
https://secure.fleetio.com/api
Auth
Parameters
— pathrequired
ResponseClear

Click the Send API Request button above and see the response here!