> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.nukio.mx/llms.txt.
> For full documentation content, see https://developers.nukio.mx/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.nukio.mx/_mcp/server.

# getDevice

GET https://app.nukio.mx/api/v1/device/getdevice/{deviceID}/authorization

Reference: https://developers.nukio.mx/nukio-api/device/get-device

## OpenAPI Specification

```yaml
openapi: 3.1.0
info:
  title: collection
  version: 1.0.0
paths:
  /api/v1/device/getdevice/{deviceID}/authorization:
    get:
      operationId: get-device
      summary: getDevice
      tags:
        - subpackage_device
      parameters:
        - name: deviceID
          in: path
          description: Device ID number
          required: true
          schema:
            type: string
        - name: authorization
          in: header
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Device_getDevice_Response_200'
servers:
  - url: https://app.nukio.mx
components:
  schemas:
    ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaStateCargoaccess:
      type: object
      properties:
        state:
          type: string
        onText:
          type: string
        offText:
          type: string
        displayName:
          type: string
        pendingState:
          type: string
        isNegativeTriggered:
          type: boolean
      required:
        - state
        - onText
        - offText
        - displayName
        - pendingState
        - isNegativeTriggered
      title: >-
        ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaStateCargoaccess
    ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaStateEnginecutoff:
      type: object
      properties:
        state:
          type: string
        onText:
          type: string
        offText:
          type: string
        displayName:
          type: string
        pendingState:
          type: string
        isNegativeTriggered:
          type: boolean
      required:
        - state
        - onText
        - offText
        - displayName
        - pendingState
        - isNegativeTriggered
      title: >-
        ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaStateEnginecutoff
    ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaState:
      type: object
      properties:
        cargoaccess:
          $ref: >-
            #/components/schemas/ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaStateCargoaccess
        enginecutoff:
          $ref: >-
            #/components/schemas/ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaStateEnginecutoff
      required:
        - cargoaccess
        - enginecutoff
      title: >-
        ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaState
    ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaSensorsIgnition:
      type: object
      properties:
        state:
          type: string
        onText:
          type: string
        offText:
          type: string
        displayName:
          type: string
        pendingState:
          description: Any type
        isNegativeTriggered:
          type: boolean
      required:
        - state
        - onText
        - offText
        - displayName
        - isNegativeTriggered
      title: >-
        ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaSensorsIgnition
    ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaSensorsCargoaccess:
      type: object
      properties:
        state:
          type: string
        onText:
          type: string
        offText:
          type: string
        displayName:
          type: string
        pendingState:
          type: string
        isNegativeTriggered:
          type: boolean
      required:
        - state
        - onText
        - offText
        - displayName
        - pendingState
        - isNegativeTriggered
      title: >-
        ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaSensorsCargoaccess
    ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaSensorsEnginecutoff:
      type: object
      properties:
        state:
          type: string
        onText:
          type: string
        offText:
          type: string
        displayName:
          type: string
        pendingState:
          type: string
        isNegativeTriggered:
          type: boolean
      required:
        - state
        - onText
        - offText
        - displayName
        - pendingState
        - isNegativeTriggered
      title: >-
        ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaSensorsEnginecutoff
    ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaSensors:
      type: object
      properties:
        ignition:
          $ref: >-
            #/components/schemas/ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaSensorsIgnition
        cargoaccess:
          $ref: >-
            #/components/schemas/ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaSensorsCargoaccess
        enginecutoff:
          $ref: >-
            #/components/schemas/ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaSensorsEnginecutoff
      required:
        - ignition
        - cargoaccess
        - enginecutoff
      title: >-
        ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaSensors
    ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaFeaturesCargoaccessStates:
      type: object
      properties:
        '0':
          type: string
        '1':
          type: string
      required:
        - '0'
        - '1'
      title: >-
        ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaFeaturesCargoaccessStates
    ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaFeaturesCargoaccess:
      type: object
      properties:
        states:
          $ref: >-
            #/components/schemas/ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaFeaturesCargoaccessStates
        displayText:
          type: string
      required:
        - states
        - displayText
      title: >-
        ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaFeaturesCargoaccess
    ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaFeaturesEnginecutoffStates:
      type: object
      properties:
        '0':
          type: string
        '1':
          type: string
      required:
        - '0'
        - '1'
      title: >-
        ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaFeaturesEnginecutoffStates
    ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaFeaturesEnginecutoff:
      type: object
      properties:
        states:
          $ref: >-
            #/components/schemas/ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaFeaturesEnginecutoffStates
        displayText:
          type: string
      required:
        - states
        - displayText
      title: >-
        ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaFeaturesEnginecutoff
    ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaFeatures:
      type: object
      properties:
        cargoaccess:
          $ref: >-
            #/components/schemas/ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaFeaturesCargoaccess
        enginecutoff:
          $ref: >-
            #/components/schemas/ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaFeaturesEnginecutoff
      required:
        - cargoaccess
        - enginecutoff
      title: >-
        ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaFeatures
    ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaAuthorities:
      type: object
      properties: {}
      title: >-
        ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaAuthorities
    Device_getDevice_Response_200:
      type: object
      properties:
        state:
          $ref: >-
            #/components/schemas/ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaState
        pinTag:
          type: string
        sensors:
          $ref: >-
            #/components/schemas/ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaSensors
        success:
          type: string
        deviceID:
          type: string
        features:
          $ref: >-
            #/components/schemas/ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaFeatures
        pinColor:
          type: string
        deviceType:
          type: string
        fuelLevels:
          type: array
          items:
            type: string
        authorities:
          $ref: >-
            #/components/schemas/ApiV1DeviceGetdeviceDeviceIdAuthorizationGetResponsesContentApplicationJsonSchemaAuthorities
        status_code:
          type: string
        deviceDriver:
          type: string
        deviceUnique:
          type: string
        deviceCreatedOn:
          type: integer
        equipmentTypeId:
          type: string
        fuelLevelAverage:
          type: string
        deviceDescription:
          type: string
        deviceDisplayName:
          type: string
        deviceNotifyEmail:
          type: string
        equipmentTypeDesc:
          type: string
        hasPendingCommands:
          type: string
        deviceLastGeozoneID:
          type: string
        deviceLastHeartbeat:
          type: integer
        additionalPinDisplay:
          type: string
        deviceLastValidSpeed:
          type: integer
        deviceLastValidAddress:
          type: string
        deviceLastValidHeading:
          type: integer
        deviceLastValidLatitude:
          type: number
          format: double
        deviceLastValidLongitude:
          type: number
          format: double
        deviceLastValidTimestamp:
          type: integer
        hasUpdateDevicePrivileges:
          type: boolean
      required:
        - state
        - pinTag
        - sensors
        - success
        - deviceID
        - features
        - pinColor
        - deviceType
        - fuelLevels
        - authorities
        - status_code
        - deviceDriver
        - deviceUnique
        - deviceCreatedOn
        - equipmentTypeId
        - fuelLevelAverage
        - deviceDescription
        - deviceDisplayName
        - deviceNotifyEmail
        - equipmentTypeDesc
        - hasPendingCommands
        - deviceLastGeozoneID
        - deviceLastHeartbeat
        - additionalPinDisplay
        - deviceLastValidSpeed
        - deviceLastValidAddress
        - deviceLastValidHeading
        - deviceLastValidLatitude
        - deviceLastValidLongitude
        - deviceLastValidTimestamp
        - hasUpdateDevicePrivileges
      title: Device_getDevice_Response_200
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: authorization

```

## SDK Code Examples

```python Device_getDevice_example
import requests

url = "https://app.nukio.mx/api/v1/device/getdevice/01/authorization"

headers = {"authorization": "<apiKey>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript Device_getDevice_example
const url = 'https://app.nukio.mx/api/v1/device/getdevice/01/authorization';
const options = {method: 'GET', headers: {authorization: '<apiKey>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Device_getDevice_example
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.nukio.mx/api/v1/device/getdevice/01/authorization"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("authorization", "<apiKey>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Device_getDevice_example
require 'uri'
require 'net/http'

url = URI("https://app.nukio.mx/api/v1/device/getdevice/01/authorization")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = '<apiKey>'

response = http.request(request)
puts response.read_body
```

```java Device_getDevice_example
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://app.nukio.mx/api/v1/device/getdevice/01/authorization")
  .header("authorization", "<apiKey>")
  .asString();
```

```php Device_getDevice_example
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://app.nukio.mx/api/v1/device/getdevice/01/authorization', [
  'headers' => [
    'authorization' => '<apiKey>',
  ],
]);

echo $response->getBody();
```

```csharp Device_getDevice_example
using RestSharp;

var client = new RestClient("https://app.nukio.mx/api/v1/device/getdevice/01/authorization");
var request = new RestRequest(Method.GET);
request.AddHeader("authorization", "<apiKey>");
IRestResponse response = client.Execute(request);
```

```swift Device_getDevice_example
import Foundation

let headers = ["authorization": "<apiKey>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://app.nukio.mx/api/v1/device/getdevice/01/authorization")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```