---
title: "GET /v1/projects/{projectOrProductUID}/devices/{deviceUID}/plans"
method: GET
path: "/v1/projects/{projectOrProductUID}/devices/{deviceUID}/plans"
tags: ["device"]
---

# GET /v1/projects/{projectOrProductUID}/devices/{deviceUID}/plans

`GET /v1/projects/{projectOrProductUID}/devices/{deviceUID}/plans`

Get Data Plans associated with the device, this include the primary sim, any external sim, as well as any satellite connections.

## Response `200`

Response body for /plans

- object
  - `cellular_plans` CellularPlan[], nullable
    - `activated` integer — Unix timestamp of when the SIM was activated
    - `data_usage` DataUsage
      - `kb_remaining` number, double, required — Kilobytes remaining in the plan
      - `kb_total` number, double, required — Total Kilobytes included in the plan
      - `kb_used` number, double, required — Kilobytes used to date
    - `expires_at` integer
    - `iccid` string — The Integrated Circuit Card Identifier of the SIM card
    - `imsi` string — IMSI of the SIM card
    - `last_updated` integer — Time this plan information was last updated
    - `lifetime_used` integer — Total bytes used by this SIM
    - `plan_type` string — Description of the SIM plan type including data allowance, region, and validity period

## Other responses

- `default` — The response body in case of an API error.

## Changes

- **2026-07-10** `1887e880199a` — 1 breaking, 6 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `default`
  - added the optional property `debug` to the response with the `default` status
  - added the optional property `details` to the response with the `default` status
  - added the optional property `request` to the response with the `default` status
  - …3 more

[Change history](https://skmtc.dev/notefile/apis/notehub-api/changes/v1/projects/:projectOrProductUID/devices/:deviceUID/plans/get.md)

---

[API](https://skmtc.dev/notefile/apis/notehub-api.md) · [All operations](https://skmtc.dev/notefile/apis/notehub-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/notefile/notehub-api/revisions/9c5b2b63a991/schema)