---
title: "List async change requests"
method: GET
path: "/asyncchangerequests"
tags: ["Async Change Requests"]
---

# List async change requests

`GET /asyncchangerequests`

## Request

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

Returns a paginated list of async change requests. Async change requests represent background operations such as plan changes and SIM configuration updates that are processed asynchronously. Non-super-admin callers only receive requests for organizations they can access.

## Query parameters

- `ids` string
- `parent_id` integer
- `orgid` integer
- `userid` integer
- `request_type` 'plan_change' | 'euicc_audit' | 'sim_configuration_update' | 'sim_state_pause' | 'sim_state_unpause' | 'sim_state_activation'
- `reference_type` 'device' | 'link' | 'simcard' | 'sim_configuration'
- `reference_id` integer
- `deviceids` string
- `states[]` string[]
- `start_after` string
- `start_before` string
- `startafter` integer
- `limit` integer

## Response `200`

OK

- ListAsyncChangeRequestsResponse
  - `success` boolean: Indicates whether the request was successful.
  - `limit` integer
  - `size` integer
  - `continues` boolean
  - `lastid` integer: ID of the last record returned, for cursor-based pagination
  - `data` AsyncChangeRequest[]
    - `id` integer: Unique request ID
    - `parent_id` integer, nullable: ID of the parent request for grouped operations
    - `orgid` integer, nullable: Organization ID associated with the request
    - `userid` integer, nullable: User ID who initiated the request
    - `request_type` 'plan_change' | 'euicc_audit' | 'sim_configuration_update' | 'sim_state_pause' | 'sim_state_unpause' | 'sim_state_activation': Type of change being requested
    - `reference_type` 'device' | 'link' | 'simcard' | 'sim_configuration': Type of the object being changed
    - `reference_id` integer: ID of the object being changed
    - `state` 'initialized' | 'in_progress' | 'complete' | 'complete_with_errors' | 'partially_complete' | 'error' | 'canceled' | 'complete_after_cancel': Current state of the request
    - `start_time` string, nullable: Timestamp when the request was created (UTC)
    - `update_time` string, nullable: Timestamp of the most recent state change (UTC)
    - `metadata` object, nullable: Metadata associated with the request
    - `child_ids` integer[]: IDs of child async change requests (included when fetching a single parent request)

## Other responses

- `400`: Invalid filter value
- `401`: Unauthorized
- `403`: Forbidden

---

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