---
title: "List SIMs (paginated)"
method: GET
path: "/devices/pages"
tags: ["SIMs (Devices)"]
---

# List SIMs (paginated)

`GET /devices/pages`

## Request

- Base URL: `https://dashboard.hologram.io/api/1`
- URL: `https://dashboard.hologram.io/api/1/devices/pages`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/hologram/apis/hologram-rest-api-v1/docs/devices/pages/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve pagination information for SIMs retrieved from `/devices` for organizations with many SIMs. This endpoint will return empty data if there are fewer SIMs than the limit specified.

## Query parameters

- `orgid` integer
- `limit` integer
- `states` string
- `deviceids` string
- `tagid` integer
- `tagids` string
- `linkids` string
- `sims` string
- `simrange` string
- `devicesPerPage` integer
- `showHidden` integer

## Response `200`

OK

- object
  - `success` boolean: Indicates whether the request was successful.
  - `limit` integer: Maximum number of results requested
  - `size` integer: Number of page boundaries returned
  - `continues` boolean: Whether more results exist beyond this page
  - `data` object[]: Page boundary device IDs. Pass each startAfterId as the startafter parameter to GET /devices to fetch that page.
    - `startAfterId` integer: Device ID marking the start of a page boundary

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/hologram/apis/hologram-rest-api-v1.md) - [All operations](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/revisions/1bc07dcd1631?raw)