---
title: "Get device"
method: GET
path: "/v2/organisations/{organisation_id}/devices/{device_id}"
tags: ["Gateway GRPC"]
---

# Get device

`GET /v2/organisations/{organisation_id}/devices/{device_id}`

## Request

- Base URL: `https://api.cautio.in` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cautio.in/v2/organisations/{organisation_id}/devices/{device_id}`
- Auth: HTTP bearer

Get a specific device by ID

## Path parameters

- `organisation_id` string, required
- `device_id` string, required

## Response `200`

Device without details

- GetDeviceResponseDto
  - `data` DeviceDto, required
    - `id` string, required: Device ID
    - `device_number` string, required: Device number
    - `alias_name` string, required: Device alias name
    - `sim_card_number` string, required: SIM card number
    - `model` DeviceModelDto, required
      - `id` string, required: Device model ID
      - `model` string, required: Device model name
      - `type` 0 | 1, required: Device type
    - `state` DeviceStateDto, required
      - `state` 0 | 1, required: Device state
    - `vehicle` DeviceVehicleDetailsDto
      - `id` string, required: Vehicle ID
      - `plate_number` string, required: Vehicle plate number
    - `details` DeviceDetailsDto
      - `dashcam` DashcamDataDto
        - `channels` ChannelDto[], required: Dashcam channels
          - `alias_name` string, required: Channel alias name
          - `enabled` boolean, required: Whether the channel is enabled
          - `index` number, required: Channel index
    - `capabilities` DeviceCapabilitiesDto
      - `audio` CapabilityDto
        - `enabled` boolean, required: Whether the capability is enabled
      - `video` CapabilityDto
        - `enabled` boolean, required: Whether the capability is enabled
      - `input` InputCapabilityDto
        - `enabled` boolean, required: Whether the capability is enabled
      - `gps` GpsCapabilityDto
        - `location` GeoPointDto
          - `longitude` number, required: Longitude
          - `latitude` number, required: Latitude
      - `fuel` FuelDataDto
        - `current_fuel_quantity` number, required: Current calculated fuel quantity
        - `current_fuel_tank_level` number, required: Current fuel tank level in millimetres
        - `maximum_fuel_tank_capacity` number, required: Configured total fuel capacity
        - `maximum_fuel_tank_level` number, required: Maximum fuel tank level in millimetres
        - `last_updated_at` string, required: Last fuel reading timestamp in milliseconds
    - `organisation` OrganisationDto
      - `id` string, required: Organisation id
      - `display_name` string, required: Display name of the organisation
      - `parent_id` string: Effective parent organisation id when accessible to the user; omitted when the physical parent exists but is inaccessible
      - `children_count` number: Number of direct child organisations visible to the user
      - `vehicle_count` number: Total number of vehicles in this organisation and its accessible sub-organisations
      - `is_setup` boolean, required: Whether first-time setup is complete for this organisation
      - `path` OrganisationDto[]: Visible ancestor chain from top-level visible ancestor to this organisation
    - `updated_at` string: Update timestamp
    - `sensors` DeviceSensorSetDto
      - `items` DeviceSensorDto[], required
        - `type` 0 | 1 | 2 | 3 | 4 | 5, required
        - `fuel` FuelSensorConfigDto
          - `tank_capacity` number, required: Fuel tank capacity
          - `calibration_rules` FuelCalibrationRuleDto[], required: Fuel calibration rules
            - `fuel_tank_level` number, required: Fuel tank level in millimetres
            - `fuel_capacity` number, required: Fuel capacity
        - `is_calibrated` boolean, required: Whether the sensor has a non-empty calibration config

---

[API](https://skmtc.dev/cautio/apis/cautio-api.md) - [All operations](https://skmtc.dev/cautio/apis/cautio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cautio/apis/cautio-api/revisions/214e6d1d2b6c?raw)