---
title: "Change SIM state (bulk)"
method: POST
path: "/devices/state"
tags: ["SIMs (Devices)"]
---

# Change SIM state (bulk)

`POST /devices/state`

## Request

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

Change the state of SIMs in multiple devices at once. Supported state values are `pause`, `live`, and `deactivate`.

Pausing the SIM will prevent your device from passing any data on all profiles installed on the SIM. Paused SIMs still incur Monthly Recurring Charges.

Deactivating permanently removes SIM cards from service and is supported from any non-deactivated state, including SIMs in Test Mode (network states of `TEST-ACTIVATE`, `TEST-HIBERNATE`, `TEST-AUTOACTIVATE`, and their `-PENDING` variants).

## Request body

- object
  - `deviceids` integer[], required: List of device IDs to update
  - `state` 'pause' | 'live' | 'deactivate', required: The new state for all SIM cards on the devices. Valid values are `pause`, `live`, or `deactivate`. Deactivation is supported from any non-deactivated state, including preflight/test mode states (TEST-ACTIVATE, TEST-HIBERNATE, TEST-AUTOACTIVATE, and their -PENDING variants).

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