List company devices
const url = 'https://api.fleet.co/platform/v1/devices?limit=50&offset=0&search=macbook%20SN123&user_id=12&client_status=ARCHIVED&location_type=NONE';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.fleet.co/platform/v1/devices?limit=50&offset=0&search=macbook%20SN123&user_id=12&client_status=ARCHIVED&location_type=NONE' \ --header 'Authorization: Bearer <token>'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Page size (max 100)
Example
50Number of items to skip
Example
0Search by device name, serial number, assignee, or team
Example
macbook SN123Filter by assigned user id
Example
12Filter by client_status (same values as the response client_status field)
Filter by location.type (same values as the response location.type field)
Responses
Section titled “Responses”Paginated devices
object
object
Company asset tag
Assigned user id; load the user with GET /users/:id
Company address where the device is kept once delivered
Company address of the first delivery
object
Where the device is now. IN_TRANSIT covers the first delivery and transfers; COMPANY_ADDRESS means it sits at assigned_address_id.
Company address of the location: the destination when IN_TRANSIT, the assigned address when COMPANY_ADDRESS. Null for Fleet-managed locations (repairer, Fleet storage, stock region, reconditioning).
Tracking page URL.
Initial delivery shipment date (ISO 8601).
Initial delivery completion date (ISO 8601).
Carrier-estimated initial delivery date (ISO 8601).
Device progress key for display and filtering
Free-form device comment
object
Keyboard layout code used for pricing and device configuration.
MDM enrollment details once enrollment has started; null otherwise
object
MDM enrollment status.
object
Order progress key for display and filtering
Display names for devices on the order
DIRECT_DELIVERY ships devices to their users; STOCK ships them to the company’s stock
Open repair; closed repairs are listed by GET /repairs?device_id=
object
Repair progress. COMPLETED and CANCELLED are closed repairs.
Tracking number of the pickup to the repairer
Tracking number of the return from the repairer
Company device lent during the repair
Current storage stay (ACTIVE or ENDING); past stays are listed by GET /storage-stays?device_id=
object
ACTIVE: stored at Fleet. ENDING: on its way back. ENDED: delivered back. CANCELLED: never stored.
Country of the Fleet storage (ISO alpha-2)
Whether the device was factory reset on intake
Condition graded on intake
Shipment to the storage; listed in the device parcels
Shipment out of the storage; listed in the device parcels
Return and inter-office shipments for this device, newest first. Initial delivery uses the device tracking_number and tracking_url. Load addresses with GET /addresses/:id.
object
RETURN: device return shipment. INTER_OFFICE_DELIVERY: inter-office move.
Parcel shipment progress. CANCELLED: the shipment was called off before delivery.
Tracking page URL.
object
Total items matching filters (before paging)
Page size used for this response
Offset used for this response
Example
{ "data": [ { "location": { "type": "NONE" }, "client_status": "ARCHIVED", "characteristics": { "keyboard_layout": "FRENCH_AZERTY" }, "mdm": { "status": "SUBSCRIBED" }, "order": { "client_status": "RECEIVED", "fulfillment_mode": "DIRECT_DELIVERY" }, "repair": { "status": "REQUEST_RECEIVED" }, "storage": { "status": "ACTIVE" }, "parcels": [ { "type": "RETURN", "status": "WAITING" } ] } ], "meta": { "total": 42, "limit": 50, "offset": 0 }}Validation error
object
Every validation failure, comma-separated
Example
{ "message": "Required, must be an ISO 3166-1 alpha-2 country code", "type": "validation_error", "error": "validation_error"}Missing, invalid, or revoked API key
Example
UnauthorizedRate limit exceeded. The RateLimit-* headers give the limit and the reset time.
Example
Too many requests, please try again later.Unexpected server error
object
Example
{ "error": "INTERNAL_ERROR"}Rate limiting is temporarily unavailable; retry with backoff
object
Example generated
{ "message": "example"}
