Get a device of my business

QA Environment

https://qa-api.kiolinkapp.com

GET

/v1/my-business/devices/{id}

My Business Devices

Last modified:2026-10-05 22:27:48

Maintainer:Not configured

Required Permission(s):mybusiness-devices-read

Returns a device of the signed-in business user's business, with its full device type and rack populated.

An ID that does not exist in the business results in HTTP 500.

Acts on the signed-in business user and their business. KIO users get HTTP 500.

Requires a session token whose role has the mybusiness-devices-read permission.

Request

Authorization

API Key

Add parameter in header

authorization

Example:

authorization: ********************

Path Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://qa-api.kiolinkapp.com/v1/my-business/devices/65f1c2a9e4b0a1b2c3d4e5d1' \
--header 'authorization: <api-key>'

Responses

🟢200The device

application/json

The device.

Bodyapplication/json

Example

{
    "_id": "65f1c2a9e4b0a1b2c3d4e5d1",
    "_devicetype": {
        "_id": "65f1c2a9e4b0a1b2c3d4e5d9",
        "name": "Servidor",
        "form": [],
        "automatic_auth": false,
        "automatic_series": false,
        "new_form": [],
        "__v": 0
    },
    "serie": "SGH123ABC",
    "marca": "HPE",
    "modelo": "ProLiant DL380 Gen10",
    "location": "MEX1",
    "fase": "F1",
    "status": "Ingresado",
    "active": true,
    "details": {
        "rack_gabinete": "R12"
    },
    "_business": "65f1c2a9e4b0a1b2c3d4e5a1",
    "movement_request": false,
    "historical": [],
    "historical_request": [],
    "created_at": "2025-01-15T18:00:00.000Z",
    "owner": "Cliente",
    "transfer_request": false,
    "__v": 0,
    "_rack": null
}

🟠401The session token expired

🟠403Not authenticated (missing/invalid token, inactive user), or

🔴500Unexpected error (e

Modified at 2026-10-05 22:27:48

Search my business's devices