---
title: "List device health"
method: GET
path: "/v2/organisations/{organisation_id}/device-health"
tags: ["Gateway GRPC"]
---

# List device health

`GET /v2/organisations/{organisation_id}/device-health`

## 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}/device-health`
- Auth: HTTP bearer

## Path parameters

- `organisation_id` string, required

## Query parameters

- `page` number
- `query` string
- `organisations` string[]
- `limit` number
- `capability` 0 | 1 | 2 | 3 | 4
- `status` 0 | 1 | 2 | 3 | 4 | 1 | 2 | 3 | 4
- `is_hung` boolean

## Response `200`

- ListDeviceHealthResponseDto
  - `data` ListDeviceHealthDataDto, required
    - `items` DeviceHealthDetailDto[], required
      - `device_id` string, required
      - `device_number` string, required
      - `alias_name` string, nullable, required
      - `organisation_id` string, required
      - `is_hung` boolean, required
      - `last_communication_at` string, nullable, required
      - `last_known_telemetry` LastKnownTelemetryDto, required
        - `recorded_at` string, nullable, required
        - `latitude` number, nullable, required
        - `longitude` number, nullable, required
        - `speed` SpeedDto, required
          - `value` number, nullable, required
          - `unit` string, required
      - `capabilities` DeviceCapabilitiesHealthDto, required
        - `sd_card` CapabilityHealthDto, required
          - `status` 'healthy' | 'faulty' | 'potential_fault' | 'NA', required
          - `occurred_at` string, nullable, required
          - `code` string, nullable, required
          - `description` string, nullable, required
        - `gps` CapabilityHealthDto, required
          - `status` 'healthy' | 'faulty' | 'potential_fault' | 'NA', required
          - `occurred_at` string, nullable, required
          - `code` string, nullable, required
          - `description` string, nullable, required
        - `camera` CapabilityHealthDto, required
          - `status` 'healthy' | 'faulty' | 'potential_fault' | 'NA', required
          - `occurred_at` string, nullable, required
          - `code` string, nullable, required
          - `description` string, nullable, required
        - `device` CapabilityHealthDto, required
          - `status` 'healthy' | 'faulty' | 'potential_fault' | 'NA', required
          - `occurred_at` string, nullable, required
          - `code` string, nullable, required
          - `description` string, nullable, required
      - `data_consumption_gb` number, required
      - `linked_to` LinkedVehicleDto, required
        - `vehicle_id` string, required
        - `plate_number` string, required
    - `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
    - `metadata` DeviceHealthMetadataDto, required
      - `total_devices` number, required
      - `online_devices` number, required
      - `offline_devices` number, required
      - `gps_faulty` CapabilityFaultCountsDto, required
        - `confirmed` number, required
        - `potential` number, required
      - `sd_card_faulty` CapabilityFaultCountsDto, required
        - `confirmed` number, required
        - `potential` number, required
      - `camera_faulty` CapabilityFaultCountsDto, required
        - `confirmed` number, required
        - `potential` number, required
      - `devices_hung` number, required
      - `data_utilised_gb` number, required

---

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