# Get a subscription

This endpoint retrieves the details of a specific subscription associated with an eSIM, identified by its ICCID. It provides information such as the subscription ID, creation date, metadata, and SIM or Physical SIM details.

Endpoint: GET /v3/subscriptions/{iccid}
Version: 1.0.0
Security: ApiKeyAuth

## Path parameters:

  - `iccid` (string, required)

## Response 200 fields (application/json):

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

  - `data` (object, required)
    Contains the details of the subscription

  - `data.subscription_id` (string, required)
    The unique identifier for the subscription
    Example: "38838e12-4394-4e04-bb11-9250e835668e"

  - `data.created_at` (string, required)
    The timestamp when the subscription was created
    Example: "2025-08-17T15:16:00.890Z"

  - `data.metadata` (string, required)
    Additional metadata related to the subscription
    Example: "Subscription for USA"

  - `data.esim` (object, required)
    Contains details about the SIM

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

  - `data.esim.iccid` (string, required)
    The ICCID of the SIM(eSIM or Physical SIM)
    Example: "8937103400004164763"

  - `data.esim.lpa_string` (string,null)
    The LPA string associated with the eSIM else null for physical SIM
    Example: "LPA:1$rsp-eu.redteamobile.com$0F222CA0C9B2F3A99457DADC94A4958C"

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

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