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

# Get devices

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

## 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`
- Auth: HTTP bearer

Get a paginated list of devices for the organisation

## Path parameters

- `organisation_id` string, required

## Query parameters

- `limit` number
- `page` number
- `query` string
- `organisations` string[]
- `is_linked` boolean
- `sort_field` 0 | 1 | 2 | 3 | 4
- `sort_direction` 0 | 1

## Response `200`

Devices without details

- GetDevicesResponseDto
  - `data` GetDevicesResponseDataDto, required
    - `items` DeviceDto[], required: List of devices
      - `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
              - …
          - `is_calibrated` boolean, required: Whether the sensor has a non-empty calibration config
    - `pagination` PaginationResponseDto, required
      - `page` number, required: Current page number
      - `limit` number, required: Number of items per page
      - `total` number, required: Total number of items
      - `has_next` boolean, required: Whether there is a next page
      - `has_prev` boolean, required: Whether there is a previous page

---

[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)