FleetbaseFleetbase

Parts

Parts represent stocked replacement components such as tires, filters, belts, electronics, and other inventory used for fleet maintenance.

The Part object

A part stores stock quantity, cost, supplier, warranty, asset association, and inventory status data.
Attributes
idstringoptional

Public part identifier.

skustringoptional

Part SKU.

namestringoptional

Part name.

quantity_on_handintegeroptional

Current stock quantity.

unit_costcurrencyoptional

Unit cost.

msrpcurrencyoptional

Suggested retail price.

vendorstringoptional

Vendor public ID, when loaded.

assetstringoptional

Associated asset public ID, when loaded.

is_in_stockbooleanoptional

Whether quantity is above zero.

metaobjectoptional

Additional part metadata.

The Part object
{
  "id": "part_8KqM3KpL2n",
  "sku": "FLT-OIL-001",
  "name": "Oil Filter",
  "quantity_on_hand": 24,
  "unit_cost": 1200,
  "currency": "USD",
  "status": "in_stock",
  "is_in_stock": true,
  "meta": {},
  "updated_at": "2026-05-07T08:30:00.000000Z",
  "created_at": "2026-05-07T08:30:00.000000Z"
}
POST/v1/parts

Create a Part

Create a part.

Body parameters
skustringoptional

Part SKU.

namestringoptional

Part name.

quantity_on_handintegeroptional

Current stock quantity.

unit_costcurrencyoptional

Unit cost.

vendorstringoptional

Vendor public ID.

asset_typestringoptional

Polymorphic resource type such as fleet-ops:vehicle or fleet-ops:equipment.

assetstringoptional

Public ID of the associated asset.

specsobjectoptional

Part specification data.

metaobjectoptional

Additional metadata.

POST/v1/parts
curl -X POST https://api.fleetbase.io/v1/parts \
  -H "Authorization: Bearer flb_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "sku": "FLT-OIL-001",
  "name": "Oil Filter",
  "quantity_on_hand": 24,
  "unit_cost": 1200,
  "currency": "USD",
  "status": "in_stock"
}'
201 OK
{
  "id": "<string>",
  "object": "parts"
}
GET/v1/parts

Query Parts

Query parts.

Query parameters
querystringoptional

Search query for parts.

limitintegeroptional

Maximum number of records to return.

pageintegeroptional

Page number for paginated results.

sortstringoptional

Sort expression, such as -created_at.

statusstringoptional

Filter by part status.

manufacturerstringoptional

Filter by manufacturer.

vendorstringoptional

Filter by vendor public ID or internal ID.

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

Retrieve a Part

Retrieve a part.

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

Update a Part

Update a part.

Body parameters
skustringoptional

Part SKU.

namestringoptional

Part name.

quantity_on_handintegeroptional

Current stock quantity.

unit_costcurrencyoptional

Unit cost.

vendorstringoptional

Vendor public ID.

asset_typestringoptional

Polymorphic resource type such as fleet-ops:vehicle or fleet-ops:equipment.

assetstringoptional

Public ID of the associated asset.

specsobjectoptional

Part specification data.

metaobjectoptional

Additional metadata.

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

Delete a Part

Delete a part.

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