v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB

SIM Cards

Get all SIM cards

Get all SIM cards belonging to the user that match the given filters.

get/sim_cards

Query parameters

iccidstring

A search string to partially match for the SIM card's ICCID.

msisdnstring

A search string to match for the SIM card's MSISDN.

statusstring[]

Filter by a SIM card's status.

tagsstring[]

A list of SIM card tags to filter on. If the SIM card contains all of the given <code>tags</code> they will be found. For example, if the SIM cards have the following tags: <ul>

<li><code>['customers', 'staff', 'test']</code> <li><code>['test']</code></li> <li><code>['customers']</code></li> </ul> Searching for <code>['customers', 'test']</code> returns only the first because it's the only one with both tags. Searching for <code>test</code> returns the first two SIMs, because both of them have such tag. Searching for <code>customers</code> returns the first and last SIMs.

Consolidated filter parameter for SIM cards (deepObject style). Originally: filter[iccid], filter[msisdn], filter[status], filter[tags]

{
  "iccid": "89310410106543789301",
  "msisdn": "+13109976224",
  "tags": [
    "personal",
    "customers",
    "active-customers"
  ]
}

numberinteger

The page number to load.

sizeinteger

The size of the page.

Consolidated pagination parameter (deepObject style). Originally: page[number], page[size]

include_sim_card_groupboolean

Example:true

It includes the associated SIM card group object in the response when present.

filter[sim_card_group_id]string uuid

Example:47a1c2b0-cc7b-4ab1-bb98-b33fb0fc61b9

A valid SIM card group ID.

sort'current_billing_period_consumed_data.amount' | '-current_billing_period_consumed_data.amount'

Sorts SIM cards by the given field. Defaults to ascending order unless field is prefixed with a minus sign.

Response

Successful response

Example response

{
  "data": [
    {
      "actions_in_progress": true,
      "authorized_imeis": [
        "106516771852751",
        "534051870479563",
        "508821468377961"
      ],
      "created_at": "2018-02-02T22:25:27.521Z",
      "current_billing_period_consumed_data": {
        "amount": "2049.0",
        "unit": "MB"
      },
      "data_limit": {
        "amount": "2048.0",
        "unit": "MB"
      },
      "esim_installation_status": "released",
      "iccid": "89310410106543789301",
      "id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
      "imsi": "081932214823362973",
      "msisdn": "+13109976224",
      "record_type": "sim_card",
      "resources_with_in_progress_actions": [],
      "sim_card_group_id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
      "status": {
        "reason": "The SIM card is active, ready to connect to networks and consume data.",
        "value": "enabled"
      },
      "tags": [
        "personal",
        "customers",
        "active-customers"
      ],
      "type": "physical",
      "updated_at": "2018-02-02T22:25:27.521Z",
      "version": "4.3"
    }
  ],
  "meta": {
    "page_number": 2,
    "page_size": 25,
    "total_pages": 3,
    "total_results": 55
  }
}