--- title: "Retrieve Equipment" method: GET path: "/equipment/{id}" tags: ["Equipment"] --- # Retrieve Equipment `GET /equipment/{id}` ## Request - Base URL: `https://secure.fleetio.com/api` - URL: `https://secure.fleetio.com/api/equipment/{id}` - Auth: API key in header `Authorization` and API key in header `Account-Token` - TypeScript: (a function with typed inputs; its response is checked against the schema) Retrieve the details of an existing Equipment. ## Path parameters - `id` string, required ## Response `200` OK - Equipment, nullable - `id` integer, required - `created_at` string, date-time, required: The date and time at which this record was created. - `updated_at` string, date-time, required: The date and time at which this record was most recently updated. - `name` string, required: The name for this Equipment. - `brand` string, nullable, required: The name of the brand which makes this Equipment. - `model` string, nullable, required: The model name of this Equipment. - `serial_number` string, nullable, required: The serial number of this Equipment. - `equipment_type_id` integer, required - `type_name` string, required: The name of the associated `Equipment Type`. - `equipment_status_id` integer, required - `status_name` string, required: The name of the associated `Equipment Status`. - `group_id` integer, nullable, required - `group_name` string, nullable, required: The name of the associated `Group`. - `purchase_vendor_id` integer, nullable, required - `purchase_price_cents` integer, nullable, required: The purchase price in cents. - `purchase_date` string, date, nullable, required: The date on which the Equipment was purchased. - `estimated_resale_price` number, float, nullable, required: The estimated resale price of this Equipment. - `warranty_expiration_date` string, date, nullable, required: The date on which the Equipment warranty expires. - `purchase_comments` string, nullable, required: Any comments about the purchase of this Equipment. - `custom_fields` CustomFields, nullable: *Full details on working with Custom Fields [here](/docs/overview/custom-fields). - `in_service_date` string, date, nullable, required: The date on which the Equipment was put into service. - `estimated_service_life` integer, nullable, required: The estimated duration in months of the service life for this Equipment. - `out_of_service_date` string, date, nullable, required: The estimated date on which the Equipment will be retired from service. - `archived_at` string, date-time, nullable, required: The date and time at which the Equipment was archived. - `status_color` string, nullable, required: The color of the associated `Equipment Status`. - `linked_vehicle` Vehicle, nullable, required: A Vehicle - `id` integer - `created_at` string, date-time - `updated_at` string, date-time - `account_id` integer - `archived_at` string, date-time, nullable: The date and time at which the Vehicle was archived. - `fuel_type_id` integer, nullable - `fuel_type_name` string, nullable: The name of the `Fuel Type` associated with this Vehicle. - `fuel_volume_units` 'us_gallons' | 'uk_gallons' | 'liters' - `group_id` integer, nullable - `group_name` string, nullable: The name of the `Group` associated with this Vehicle. - `meter_unit` 'km' | 'hr' | 'mi', nullable: The measurement unit used for the Vehicle's primary, or secondary (if applicable), meter. - `name` string: This Vehicle's name. - `ownership` 'Owned' | 'Leased' | 'Rented' | 'Customer' | 'Financed' | 'Rent To Own' - `secondary_meter` boolean: Indicates whether or not this Vehicle has a secondary meter. - `secondary_meter_unit` 'km' | 'hr' | 'mi', nullable: The measurement unit used for the Vehicle's primary, or secondary (if applicable), meter. - `system_of_measurement` 'imperial' | 'metric' - `labels` object[]: The `Labels` associated with this Vehicle. Available by passing the `expand=labels` query parameter. - `id` integer - `name` string: The name of the Label. This is the value used to tag a record. - `color` string: The hex color of the Label. - `vehicle_status_id` integer - `vehicle_status_name` string: The name of the `Vehicle Status` associated with this Vehicle. - `vehicle_status_color` string, nullable: The color of the `Vehicle Status` associated with this Vehicle. - `vehicle_type_id` integer - `vehicle_type_name` string: The name of the `Vehicle Type` associated with this Vehicle. - `fuel_entries_count` integer: The number of `Fuel Entries` associated with this Vehicle. - `service_entries_count` integer: The number of `Service Entries` associated with this Vehicle. - `service_reminders_count` integer: The number of `Service Reminders` associated with this Vehicle. - `vehicle_renewal_reminders_count` integer: The number of `Vehicle Renewal Reminders` associated with this Vehicle. - `comments_count` integer: The number of `Comments` associated with this Vehicle. - `documents_count` integer: The number of documents attached to this Vehicle. - `images_count` integer: The number of images attached to this Vehicle. - `current_location_entry_id` integer, nullable - `is_sample` boolean: Indicates whether this Vehicle record is [Sample Data](https://help.fleetio.com/s/article/Sample-Data). - `in_service_date` string, date-time, nullable: The date on which this Vehicle was put into service. - `in_service_meter` number, float, nullable: The meter value at which this Vehicle was put into service. - `estimated_service_months` integer, nullable: The estimated number of months this Vehicle will be in service. - `estimated_replacement_mileage` number, float, nullable: The estimated number of miles before which this Vehicle will be replaced. - `estimated_resale_price` object, nullable: The estimated resale price of this Vehicle. - `cents` integer: The estimated resale price of this Vehicle in cents. - `currency_iso` string: The ISO 4217 currency code of the estimated resale price. - `out_of_service_date` string, date-time, nullable: The date on which this Vehicle was or will be retired. - `out_of_service_meter` number, float, nullable: The meter value at which this Vehicle was or will be retired. - `meter_name` string: The name of the primary meter for this Vehicle. - `secondary_meter_name` string: The name of the secondary meter for this Vehicle. - `primary_meter_usage_per_day` string, nullable: The average number of units of the primary meter used per day. - `secondary_meter_usage_per_day` string, nullable: The average number of units of the secondary meter used per day. - `current_meter_value` number, float, nullable: The current value of the primary meter for this Vehicle. - `current_meter_date` string, date-time, nullable: The date and time at which the primary meter was last updated. - `secondary_meter_value` number, float, nullable: The current value of the secondary meter for this Vehicle. - `secondary_meter_date` string, date-time, nullable: The date and time at which the secondary meter was last updated. - `group_ancestry` string, nullable: The ancestry of the Group associated with this Vehicle. - `color` string, nullable: The color of this Vehicle. - `license_plate` string, nullable: The license plate number of this Vehicle. - `vin` string, nullable: The Vehicle Identification Number of this Vehicle. - `year` number, nullable: This Vehicle's model year. - `make` string, nullable: The name of this Vehicle's manufacturer. - `model` string, nullable: The name of the model of this Vehicle. - `trim` string, nullable: The trim level of this Vehicle. - `registration_expiration_month` integer, nullable: The month in which this Vehicle's registration expires. - `registration_state` string, nullable: The state, province, or territory in which this Vehicle is registered. - `loan_account_number` string, nullable: The account number for this Vehicle's loan, if applicable. - `loan_ended_at` string, date-time, nullable: The date and time at which this Vehicle's loan ends. - `loan_interest_rate` number, float, nullable: The interest rate for this Vehicle's loan. - `loan_notes` string, nullable: Notes about this Vehicle's loan. - `loan_started_at` string, date-time, nullable: The date and time at which this Vehicle's loan began. Formatted according to ISO-8601 in `User`'s local time. - `loan_vendor_id` integer, nullable - `loan_vendor_name` string, nullable: The name of the `Vendor` for this Vehicle's loan. - `custom_fields` CustomFields, nullable: *Full details on working with Custom Fields [here](/docs/overview/custom-fields). - `inspection_schedules_count` integer: The number of inspection schedules this Vehicle is associated with. - `issues_count` integer: The number of `Issues` this Vehicle is associated with. - `work_orders_count` integer: The number of `Work Orders` this Vehicle is associated with. - `type_name` string, nullable: The name of the `Vehicle Type` associated with this Vehicle. - `default_image_url` string, nullable: The URL of the default image for this Vehicle. - `default_image_url_medium` string, nullable: The URL of a medium-sized version of the default image for this Vehicle. - `default_image_url_small` string, nullable: The URL of a small-sized version of the default image for this Vehicle. - `default_image_url_large` string, nullable: The URL of a large-sized version of the default image for this Vehicle. - `specs` VehicleSpecs - `id` integer - `vehicle_id` integer: The `Vehicle` ID these specs belong to. - `account_id` integer - `body_type` string, nullable: The body type of the Vehicle, if available. - `body_subtype` string, nullable: The subtype of the Vehicle body, if available. - `drive_type` string, nullable: The drive type of the Vehicle, if available. - `brake_system` string, nullable: The brake system used in the Vehicle, if available. - `msrp_cents` integer, nullable: The Manufacturer's Suggested Retail Price (MSRP) in cents, if available. - `fuel_tank_capacity` number, float, nullable: The fuel tank capacity of the Vehicle, if available. - `fuel_tank_2_capacity` number, float, nullable: The capacity of a second fuel tank, if available. - `front_track_width` number, float, nullable: The front track width of the Vehicle, if available. - `ground_clearance` number, float, nullable: The ground clearance of the Vehicle, if available. - `height` number, float, nullable: The height of the Vehicle, if available. - `length` number, float, nullable: The length of the Vehicle, if available. - `rear_track_width` number, float, nullable: The rear track width of the Vehicle, if available. - `width` number, float, nullable: The width of the Vehicle, if available. - `wheelbase` number, float, nullable: The wheelbase of the Vehicle, if available. - `front_tire_psi` string, nullable: The recommended PSI for front tires, if available. - `rear_tire_psi` string, nullable: The recommended PSI for rear tires, if available. - `base_towing_capacity` number, float, nullable: The base towing capacity of the Vehicle, if available. - `curb_weight` number, float, nullable: The curb weight of the Vehicle, if available. - `gross_vehicle_weight_rating` number, float, nullable: The Gross Vehicle Weight Rating (GVWR), if available. - `bed_length` string, nullable: The length of the Vehicle's bed, if available. - `max_payload` number, float, nullable: The maximum payload capacity of the Vehicle, if available. - `rear_axle_type` string: The type of rear axle used in the Vehicle. - `front_tire_type` string: The type of front tires used in the Vehicle. - `front_wheel_diameter` string: The diameter of the front wheels. - `rear_tire_type` string: The type of rear tires used in the Vehicle. - `rear_wheel_diameter` string: The diameter of the rear wheels. - `epa_city` number, float, nullable: The EPA city fuel economy rating, if available. - `epa_highway` number, float, nullable: The EPA highway fuel economy rating, if available. - `epa_combined` number, float, nullable: The combined EPA fuel economy rating, if available. - `engine_description` string: Description of the Vehicle's engine. - `engine_brand` string: Brand of the Vehicle's engine. - `engine_aspiration` string, nullable: Aspiration type of the engine, if available. - `engine_block_type` string, nullable: Block type of the engine, if available. - `engine_bore` number, float, nullable: Bore size of the engine, if available. - `engine_cam_type` string, nullable: Camshaft type of the engine, if available. - `engine_compression` number, float, nullable: Compression ratio of the engine, if available. - `engine_cylinders` integer, nullable: Number of engine cylinders, if available. - `engine_displacement` number, float, nullable: Engine displacement, if available. - `fuel_induction` string, nullable: Fuel induction method, if available. - `fuel_quality` string: Fuel quality required for the engine. - `max_hp` integer, nullable: Maximum horsepower produced by the engine, if available. - `max_torque` integer, nullable: Maximum torque produced by the engine, if available. - `oil_capacity` number, float, nullable: Oil capacity of the engine, if available. - `redline_rpm` string: Redline RPM of the engine. - `engine_stroke` number, float, nullable: Stroke length of the engine, if available. - `engine_valves` integer, nullable: Number of engine valves, if available. - `transmission_description` string: Description of the Vehicle's transmission. - `transmission_brand` string: Brand of the Vehicle's transmission. - `transmission_type` string, nullable: Type of transmission, if available. - `transmission_gears` integer, nullable: Number of gears in the transmission, if available. - `cargo_volume` number, float, nullable: Cargo volume of the Vehicle, if available. - `interior_volume` number, float, nullable: Interior volume of the Vehicle, if available. - `passenger_volume` string: Passenger volume of the Vehicle. - `created_at` string, date-time: The date and time when the specs were created. - `updated_at` string, date-time: The date and time when the specs were last updated. - `duty_type` string, nullable: Type of duty the Vehicle is designed for, if available. - `weight_class` string, nullable: Weight class of the Vehicle, if available. - `engine_bore_with_units` string, nullable: Bore size of the engine with units, if available. - `wheelbase_with_units` string, nullable: Wheelbase of the Vehicle with units, if available. - `msrp` string, nullable: Manufacturer's Suggested Retail Price (MSRP). - `external_ids` object: Any [External IDs](/docs/guides/vehicles/external-vehicle-ids) associated with this Vehicle. - `ai_enabled` boolean: Whether this Vehicle has [Auto Integrate](https://help.fleetio.com/s/article/FAQ-Maintenance-Shop-Integration) enabled for it. - `assetable_type` 'Vehicle': Assetable type for Vehicle is always `Vehicle` for vehicles. - `driver` object - `id` integer, nullable - `first_name` string, nullable: The first name of the `Contact` (driver) associated with this Vehicle. - `last_name` string, nullable: The last name of the `Contact` (driver) associated with this Vehicle. - `full_name` string, nullable: The full name of the `Contact` (driver) associated with this Vehicle. - `employee` boolean, nullable: Whether or not the `Contact` (driver) associated with this Vehicle is an employee. - `employee_number` string, nullable: The employee number of the `Contact` (driver) associated with this Vehicle. - `default_image_url` string, nullable: The URL of the default image of the `Contact` (driver) associated with this Vehicle. - `current_location_entry` CurrentLocationEntry, nullable: The current location of the associated object. - `id` integer: The unique identifier for the current Location Entry. - `locatable_type` string: The type of object that this Location Entry is associated with. - `locatable_id` integer: The unique identifier of the object that this Location Entry is associated with. - `date` string, date-time: The date and time when this Location Entry was recorded. - `created_at` string, date-time: The date and time when this Location Entry was created. - `updated_at` string, date-time: The date and time when this Location Entry was last updated. - `contact_id` integer: The unique identifier of the associated Contact. - `address` string: The address associated with this Location Entry. - `is_current` boolean: Indicates whether this Location Entry is the current location. - `item_type` string: The type of item associated with this Location Entry. - `item_id` integer: The unique identifier of the item associated with this Location Entry. - `location` string: The geographical location in the format "POINT (longitude latitude)". - `address_components` object - `street_number` string: The street number in the address. - `street` string: The street name in the address. - `city` string: The city in the address. - `region` string: The region, state or province in the address. - `region_short` string: The abbreviated region, state or province code. - `country` string: The country in the address. - `country_short` string: The abbreviated country code. - `postal_code` string: The postal code, ZIP, or equivalent in the address. - `geolocation` object - `latitude` number, float: The latitude coordinate of the location. - `longitude` number, float: The longitude coordinate of the location. - `loan_amount` number, float, nullable: The amount of this Vehicle's loan. - `loan_payment` number, float, nullable: The amount of this Vehicle's loan payment. - `warranties_active_count` integer: The number of active warranties associated with this Vehicle. - `warranties_count` integer: The number of warranties associated with this Vehicle. - `residual_value` number, float, nullable: The residual value of this Vehicle at the end of its lease. - `axle_config_id` integer, nullable: The id of the `Axle Configuration` of this vehicle. - `assigned_contact` Contact, nullable, required: A Contact - `id` integer - `created_at` string, date-time - `updated_at` string, date-time - `email` string, nullable: The Contact's email address. - `name` string, nullable: The Contact's full name. - `first_name` string, nullable: The Contact's first name. - `middle_name` string, nullable: The Contact's middle name. - `last_name` string, nullable: The Contact's last name. - `images_count` integer: The number of images associated with this Contact. - `documents_count` integer: The number of documents associated with this Contact. - `comments_count` integer: The number of comments associated with this Contact. - `group_id` integer, nullable: If this Contact belongs to a [Group](/docs/api/groups), this will be the Fleetio ID of that `Group`. - `group_name` string, nullable: If this Contact belongs to a [Group](/docs/api/groups), this will be the `Group`'s name. - `group_hierarchy` string, nullable: If this Contact belongs to a [Group](/docs/api/groups), this will be a pipe delimited string representing the `Group` hierarchy. Each `Group` in the list is the parent of the `Groups` which follow. - `technician` boolean, nullable: Whether or not the Contact is a Technician. - `vehicle_operator` boolean, nullable: Whether or not the Contact is a Vehicle Operator. - `employee` boolean, nullable: Whether or not the Contact is an Employee. - `birth_date` string, date, nullable: The Contact's birth date. - `street_address` string, nullable: The Contact's street address. - `street_address_line_2` string, nullable: The Contact's street address line 2. - `city` string, nullable: The Contact's city. - `region` string, nullable: The Contact's region, state, or province. - `postal_code` string, nullable: The Contact's postal code, zip code, or equivalent. - `country` string, nullable: The Contact's country. - `employee_number` string, nullable: The Contact's employee number. - `job_title` string, nullable: The Contact's job title. - `license_class` string, nullable: The Contact's driver's license class. - `license_number` string, nullable: The Contact's driver's license number. - `license_state` string, nullable: The locality which issued the Contact's license. - `license_expiration` string, date, nullable: The Contact's driver's license expiration date. - `home_phone_number` string, nullable: The Contact's home phone number. - `mobile_phone_number` string, nullable: The Contact's mobile phone number. - `work_phone_number` string, nullable: The Contact's work phone number. - `other_phone_number` string, nullable: Any other phone number for this Contact. - `start_date` string, date, nullable: When the Contact started working for the company, if applicable. - `leave_date` string, date, nullable: When the Contact left or will leave the company, if applicable. - `hourly_labor_rate` number, float, nullable: The Contact's hourly rate. - `custom_fields` CustomFields, nullable: *Full details on working with Custom Fields [here](/docs/overview/custom-fields). - `attachment_permissions` AttachmentPermissions, nullable - `read_photos` boolean: Indicates whether the user has read permission for photos. - `manage_photos` boolean: Indicates whether the user has permission to manage (eg. upload, delete) photos. - `read_documents` boolean: Indicates whether the user has read permission for documents. - `manage_documents` boolean: Indicates whether the user has permission to manage (eg. upload, delete) documents. - `default_image_url` string, nullable: The URL of the Contact's default image/profile photo, if any. - `user` object, nullable: If the Contact is a Fleetio `User`, those details will be included here. - `account_membership_id` integer, nullable - `last_api_request` string, date-time, nullable: The last date and time this Contact's associated User made an API request. Null if Contact is not associated with a User. - `last_web_access` string, date-time, nullable: The last date and time this Contact's associated User signed into the web application. Null if Contact is not associated with a User. - `last_mobile_app_access` string, date-time, nullable: The last date and time this Contact's associated User used the mobile app. Null if Contact is not associated with a User. - `attachment_permissions` AttachmentPermissions, nullable, required - `read_photos` boolean: Indicates whether the user has read permission for photos. - `manage_photos` boolean: Indicates whether the user has permission to manage (eg. upload, delete) photos. - `read_documents` boolean: Indicates whether the user has read permission for documents. - `manage_documents` boolean: Indicates whether the user has permission to manage (eg. upload, delete) documents. - `default_image_url` string, nullable, required: The URL of the Equipment's default image/profile photo, if any. - `assetable_type` string, nullable, required: The type of assetable object. - `issues_count` integer, required: The number of `Issues` associated with this Equipment. - `current_location_entry` CurrentLocationEntry, nullable, required: The current location of the associated object. - `id` integer: The unique identifier for the current Location Entry. - `locatable_type` string: The type of object that this Location Entry is associated with. - `locatable_id` integer: The unique identifier of the object that this Location Entry is associated with. - `date` string, date-time: The date and time when this Location Entry was recorded. - `created_at` string, date-time: The date and time when this Location Entry was created. - `updated_at` string, date-time: The date and time when this Location Entry was last updated. - `contact_id` integer: The unique identifier of the associated Contact. - `address` string: The address associated with this Location Entry. - `is_current` boolean: Indicates whether this Location Entry is the current location. - `item_type` string: The type of item associated with this Location Entry. - `item_id` integer: The unique identifier of the item associated with this Location Entry. - `location` string: The geographical location in the format "POINT (longitude latitude)". - `address_components` object - `street_number` string: The street number in the address. - `street` string: The street name in the address. - `city` string: The city in the address. - `region` string: The region, state or province in the address. - `region_short` string: The abbreviated region, state or province code. - `country` string: The country in the address. - `country_short` string: The abbreviated country code. - `postal_code` string: The postal code, ZIP, or equivalent in the address. - `geolocation` object - `latitude` number, float: The latitude coordinate of the location. - `longitude` number, float: The longitude coordinate of the location. - `comments_count` integer, required: The number of `Comments` associated with this Equipment. - `documents_count` integer, required: The number of documents associated with this Equipment. - `images_count` integer, required: The number of images associated with this Equipment. - `is_watched` boolean, required: Indicates whether this Equipment is being watched. - `watchers_count` integer, required: The number of users watching this Equipment. ## Other responses - `401`: Request could not be authenticated - `403`: Insufficient permission to perform this operation - `404`: The requested resource could not be located - `500`: Something unexpected happened ## Changes - **2026-06-16** `4098a1c81821`: 11 breaking - the `allOf[subschema #2]/linked_vehicle/estimated_replacement_mileage` response's property type changed from `string` to `number`, and format from no format to `float` for status `200` - the `allOf[subschema #2]/linked_vehicle/specs/base_towing_capacity` response's property type changed from `string` to `number`, and format from no format to `float` for status `200` - the `allOf[subschema #2]/linked_vehicle/specs/engine_bore` response's property type changed from `string` to `number`, and format from no format to `float` for status `200` - the `allOf[subschema #2]/linked_vehicle/specs/engine_compression` response's property type changed from `string` to `number`, and format from no format to `float` for status `200` - …7 more - **2026-02-13** `1172c0b6ab85`: 2 warning - added the new `Financed` enum value to the `allOf[subschema #2]/linked_vehicle/ownership` response property for the response status `200` - added the new `Rent To Own` enum value to the `allOf[subschema #2]/linked_vehicle/ownership` response property for the response status `200` - **2025-09-06** `6daa53a03224`: 2 info - added the optional property `allOf[subschema #2]/linked_vehicle/driver/employee` to the response with the `200` status - added the optional property `allOf[subschema #2]/linked_vehicle/driver/employee_number` to the response with the `200` status [Operation history](https://skmtc.dev/fleetio/apis/fleetio-developer-api/changes/equipment/:id/get.md) --- [API](https://skmtc.dev/fleetio/apis/fleetio-developer-api.md) - [All operations](https://skmtc.dev/fleetio/apis/fleetio-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fleetio/apis/fleetio-developer-api/revisions/49558d744bd7?raw)