---
title: "Change SIM data plan"
method: POST
path: "/devices/{deviceId}/changeplan"
tags: ["SIMs (Devices)"]
---

# Change SIM data plan

`POST /devices/{deviceId}/changeplan`

## Request

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

Change the data plan for the given device. Non-pending paused profiles (PAUSED-USER, PAUSED-SYS) can change plans when the new plan uses the same CSP (no coverage change). Pending paused profiles remain rejected. Warning: Changing data plans will remove any set data limits.

## Path parameters

- `deviceId` integer, required

## Query parameters

- `preview` boolean

## Request body

- object
  - `planid` integer, required: ID of the data plan to assign
  - `zone` string, required: Geographic zone for the plan
  - `orgid` integer, required: Organization ID of the devices to change plans for
  - `overage_limit` integer: Additional bytes of data allowed above the plan's included data; SIM pauses when usage exceeds plan included data plus this value (-1 for unlimited, 0 for plan included data only)
  - `useacctbalance` boolean: Apply account balance credit to this order

## Response `200`

OK

- SimpleSuccessResponse
  - `success` boolean: Indicates whether the request was successful.

## Other responses

- `400`: Bad request
- `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)