---
title: "Get device count history"
method: GET
path: "/device-counts"
tags: ["Device Counts"]
---

# Get device count history

`GET /device-counts`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/device-counts`
- Auth: none declared

Returns device count history.

## Query parameters

- `skip` integer: Number of results to skip. Used for pagination.
- `limit` integer: Number of results to return. Used for pagination.
- `order` 'newest' | 'oldest'
- `serverId` string
- `before` integer
- `after` integer

## Response `200`

The device counts matching the specified query.

- DeviceCountsGetDeviceCountsResponse200
  - `results` IapDeviceCountSchema: This is the schema for an IAP device count stored in Mongo
    - `timestamp` string, required: An ISODate representing when the device count was taken
    - `serverId` string, required: The serverId where the device count was taken
    - `counts` object, required: The key/value pair between an adapter name and the number of devices
  - `total` integer: The total number of documents

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Device Counts` added
  - api tag `deviceCounts` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/device-counts/get.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)