---
title: "List SIM configurations"
method: GET
path: "/simcards/configurations/"
tags: ["SIM Configuration"]
---

# List SIM configurations

`GET /simcards/configurations/`

## Request

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

Returns available sim configurations based on the plans visible to all of a user's orgs. Optionally filter specific configurations with the parameters below.

## Query parameters

- `ids` string
- `carrier_ids` string
- `disabled_carrier_ids` string
- `enabled_carrier_id` integer
- `fallback_carrier_id` integer
- `name` string
- `plan_ids` string
- `orgid` integer
- `limit` integer
- `startafter` integer

## Response `200`

OK

- SimConfigurationListResponse
  - `success` boolean: Indicates whether the request was successful.
  - `limit` integer
  - `size` integer
  - `continues` boolean
  - `lastid` integer
  - `links` PaginationLinks
    - `path` string: The API endpoint path
    - `base` string: The API base URL
    - `next` string: URL to retrieve the next page of results
  - `data` SimConfigurationObject[]
    - `id` integer
    - `name` string
    - `description` string, nullable
    - `enabled_carrier_id` integer
    - `fallback_carrier_id` integer
    - `disabled_carrier_ids` integer[]
    - `applicable_plan_ids` integer[], nullable: Only present when plan_ids or orgid is included in the request

## Other responses

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