# List SIMs

This endpoint retrieves a list of SIMs(both eSIMs and physical sim cards) associated with organization.

Endpoint: GET /v3/sims
Version: 1.0.0
Security: ApiKeyAuth

## Query parameters:

  - `page_size` (string)

  - `page` (string)

  - `is_esim` (boolean)

  - `label` (string)
    Example: "Green"

## Response 200 fields (application/json):

  - `error` (boolean, required)
    Indicates whether an error occurred during the request

  - `data` (array, required)
    Contains an array of SIM objects

  - `data.iccid` (string, required)
    The Integrated Circuit Card Identifier of the eSIM
    Example: "8937103400004164763"

  - `data.label` (string, required)
    A label for the eSIM
    Example: "Blue"

  - `data.lpa` (string,null)
    The Local Profile Assistant associated with the eSIM if the SIM is an eSIM
    Example: "LPA:1$rsp-eu.redteamobile.com$0F222CA0C9B2F3A99457DADC94A4958C"

  - `data.used` (boolean)
    Indicates if the SIM has been used or not

  - `data.esim_id` (string, required)
    The unique identifier for the eSIM
    Example: "5a15183b-ca25-4725-b8a8-807990f98e03"

  - `data.created_at` (string, required)
    The timestamp when the SIM was created
    Example: "2025-08-11T14:43:15.761Z"

  - `data.is_esim` (boolean, required)
    Indicates if the item is an eSIM or not
    Example: true

  - `next_page` (string,null, required)
    A token for pagination, indicating if there are more results available
    Example: "MQ=="

## Response 401 fields (application/json):

  - `error` (boolean, required)
    Indicates whether an error occurred during the request
    Example: true

  - `message` (string, required)
    Error message describing the unauthorized access
    Example: "Unauthorized: API key is missing"