---
title: "Retrieve a list of Settings Updates."
method: GET
path: "/v1/SettingsUpdates"
tags: ["SupersimV1SettingsUpdate"]
---

# Retrieve a list of Settings Updates.

`GET /v1/SettingsUpdates`

Retrieve a list of Settings Updates.

## Query parameters

- `Sim` string
- `Status` 'scheduled' | 'in-progress' | 'successful' | 'failed' — The Status of this Settings Update. One of `scheduled`, `in-progress`, `successful` or `failed`.
- `PageSize` integer
- `Page` integer
- `PageToken` string

## Response `200`

OK

- object
  - `settings_updates` SupersimV1SettingsUpdate[]
    - `sid` string, nullable — The unique identifier of this Settings Update.
    - `iccid` string, nullable — The [ICCID](https://en.wikipedia.org/wiki/SIM_card#ICCID) associated with the SIM.
    - `sim_sid` string, nullable — The SID of the Super SIM to which this Settings Update was applied.
    - `status` 'scheduled' | 'in-progress' | 'successful' | 'failed' — The Status of this Settings Update. One of `scheduled`, `in-progress`, `successful` or `failed`.
    - `packages` unknown[], nullable — Array containing the different Settings Packages that will be applied to the SIM after the update completes. Each object within the array indicates the name and the version of the Settings Package that will be on the SIM if the update is successful.
      - unknown
    - `date_completed` string, date-time, nullable — The time, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format, when the update successfully completed and the new settings were applied to the SIM.
    - `date_created` string, date-time, nullable — The date that this Settings Update was created, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `date_updated` string, date-time, nullable — The date that this Settings Update was updated, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `meta` object
    - `first_page_url` string, uri
    - `key` string
    - `next_page_url` string, uri, nullable
    - `page` integer
    - `page_size` integer
    - `previous_page_url` string, uri, nullable
    - `url` string, uri

---

[API](https://skmtc.net/twilio/apis/supersim-v1.md) · [All operations](https://skmtc.net/twilio/apis/supersim-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/supersim-v1/versions/c0baa6eaf932/schema)