# List Subscriptions

This endpoint allows users to retrieve subscription details associated with the SIM service. It provides information about the subscription, including its ID, creation date, associated metadata, and SIM details.

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

## Response 200 fields (application/json):

  - `error` (boolean, required)
    Indicates whether there was an error in the request

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

  - `data.subscription_id` (string, required)
    The unique identifier for the subscription
    Example: "6174d2d5-f3bd-4336-abe0-13d75cc8a023"

  - `data.created_at` (string, required)
    The timestamp when the subscription was created
    Example: "2025-08-24T14:59:38.037Z"

  - `data.metadata` (string, required)
    Additional metadata related to the subscription
    Example: "usa plan applied"

  - `data.esim` (object, required)

  - `data.esim.esim_id` (string, required)
    The unique identifier for the eSIM
    Example: "67940632-e09e-4c16-b220-1b47988d50b6"

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

  - `data.esim.lpa_string` (string,null)
    The LPA string associated with the eSIM if it is an eSIM else null.
    Example: "LPA:1$smdp.io$K2-2GNHV6-USUV2O"

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

## 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"