FleetbaseFleetbase

Equipment

Equipment represents auxiliary fleet gear such as PPE, refrigeration units, tools, liftgates, ramps, containers, and other assignable operational equipment.

The Equipment object

An equipment record stores identity, assignment, warranty, purchase, and status details for reusable fleet equipment.
Attributes
idstringoptional

Public equipment identifier.

namestringoptional

Equipment name.

codestringoptional

Internal equipment code.

typestringoptional

Equipment type.

statusstringoptional

Equipment availability status.

serial_numberstringoptional

Equipment serial number.

manufacturerstringoptional

Equipment manufacturer.

modelstringoptional

Equipment model.

equipablestringoptional

Public ID of the assigned resource, when loaded.

equipable_typestringoptional

Public attachment type such as fleet-ops:vehicle or fleet-ops:trailer.

equipable_idstringoptional

Public ID of the attached Vehicle or Trailer.

equipable_namestringoptional

Display name of the attached Vehicle or Trailer.

metaobjectoptional

Additional equipment metadata.

The Equipment object
{
  "id": "equipment_4Mnp8Qx2Vz",
  "name": "Liftgate LG-12",
  "code": "LG-12",
  "type": "liftgate",
  "status": "available",
  "serial_number": "LG120045",
  "manufacturer": "Maxon",
  "model": "BMR",
  "currency": "USD",
  "is_equipped": false,
  "meta": {},
  "updated_at": "2026-05-07T08:30:00.000000Z",
  "created_at": "2026-05-07T08:30:00.000000Z"
}
POST/v1/equipment

Create Equipment

Create equipment.

Body parameters
namestringoptional

Equipment name.

codestringoptional

Internal equipment code.

typestringoptional

Equipment type.

statusstringoptional

Equipment status.

warrantystringoptional

Warranty public ID.

photostringoptional

File public ID for the equipment photo.

equipable_typestringoptional

Polymorphic resource type such as fleet-ops:vehicle, fleet-ops:trailer, or the existing fleet-ops:driver compatibility type.

equipablestringoptional

Public ID of the resource to assign equipment to.

metaobjectoptional

Additional metadata.

POST/v1/equipment
curl -X POST https://api.fleetbase.io/v1/equipment \
  -H "Authorization: Bearer flb_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Liftgate LG-12",
  "code": "LG-12",
  "type": "liftgate",
  "status": "available",
  "serial_number": "LG120045",
  "manufacturer": "Maxon",
  "model": "BMR",
  "currency": "USD"
}'
201 OK
{
  "id": "<string>",
  "object": "equipment"
}
GET/v1/equipment

Query Equipment

Query equipment.

Query parameters
querystringoptional

Search query for equipment.

limitintegeroptional

Maximum number of records to return.

pageintegeroptional

Page number for paginated results.

sortstringoptional

Sort expression, such as -created_at.

typestringoptional

Filter by equipment type.

statusstringoptional

Filter by equipment status.

manufacturerstringoptional

Filter by manufacturer.

GET/v1/equipment
curl https://api.fleetbase.io/v1/equipment \
  -H "Authorization: Bearer flb_live_…"
200 OK
{
  "id": "<string>",
  "object": "equipment"
}
GET/v1/equipment

Retrieve Equipment

Retrieve equipment.

GET/v1/equipment
curl https://api.fleetbase.io/v1/equipment \
  -H "Authorization: Bearer flb_live_…"
200 OK
{
  "id": "<string>",
  "object": "equipment"
}
PUT/v1/equipment

Update Equipment

Update equipment.

Body parameters
namestringoptional

Equipment name.

codestringoptional

Internal equipment code.

typestringoptional

Equipment type.

statusstringoptional

Equipment status.

warrantystringoptional

Warranty public ID.

photostringoptional

File public ID for the equipment photo.

equipable_typestringoptional

Polymorphic resource type such as fleet-ops:vehicle, fleet-ops:trailer, or the existing fleet-ops:driver compatibility type.

equipablestringoptional

Public ID of the resource to assign equipment to.

metaobjectoptional

Additional metadata.

PUT/v1/equipment
curl -X PUT https://api.fleetbase.io/v1/equipment \
  -H "Authorization: Bearer flb_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "maintenance"
}'
200 OK
{
  "id": "<string>",
  "object": "equipment"
}
DELETE/v1/equipment

Delete Equipment

Delete equipment.

DELETE/v1/equipment
curl -X DELETE https://api.fleetbase.io/v1/equipment \
  -H "Authorization: Bearer flb_live_…"
200 OK
{
  "id": "<string>",
  "deleted": true
}
POST/v1/equipment/:id/attach

Attach Equipment

Attach or atomically reassign Equipment to a Vehicle or Trailer.

Body parameters
attachable_typeenumoptional

Allowed target resource type. One of fleet-ops:vehicle, fleet-ops:trailer.

attachablestringoptional

Vehicle or Trailer public ID.

POST/v1/equipment/:id/attach
curl -X POST https://api.fleetbase.io/v1/equipment/:id/attach \
  -H "Authorization: Bearer flb_live_…" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"attachable_type":"fleet-ops:vehicle","attachable":"{{vehicle_id}}"}'
POST/v1/equipment/:id/detach

Detach Equipment

Detach Equipment from its current Vehicle or Trailer.

POST/v1/equipment/:id/detach
curl -X POST https://api.fleetbase.io/v1/equipment/:id/detach \
  -H "Authorization: Bearer flb_live_…" \
  -H "Accept: application/json"
Equipment | Fleetbase