Get one device
const url = 'https://api.fleet.co/platform/v1/devices/42';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/42 \ --header 'Authorization: Bearer <token>'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Device id
Example
42Responses
Section titled “Responses”Device
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.
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" } ] }}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
UnauthorizedNot found
object
Example
{ "error": "DEVICE_NOT_FOUND"}Rate 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"}
