# List plan attachments

This endpoint retrieves the plan attachments associated with a specific subscription identified by its ICCID.

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

## Path parameters:

  - `iccid` (string, required)

## Response 200 fields (application/json):

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

  - `data` (array, required)
    An array containing details of the plan attachments

  - `data.plan_attachment_id` (string, required)
    The unique identifier for the plan attachment
    Example: "efff707e-7db0-4ffe-bef9-5817cabcba3b"

  - `data.created_at` (string, required)
    The timestamp when the plan attachment was created
    Example: "2025-08-17T15:15:59.000Z"

  - `data.activation_at` (string,null)
    The timestamp when the plan attachment was activated (may be null)
    Example: "2025-08-17T15:15:59.000Z"

  - `data.expiration_at` (string,null)
    The timestamp when the plan attachment will expire (may be null)
    Example: "2025-08-17T15:15:59.000Z"

  - `data.used_allowance` (object, required)
    An object containing usage details

  - `data.used_allowance.dataBytes` (number, required)
    The amount of data used in bytes
    Example: 100

  - `data.state` (string, required)
    The current state of the plan attachment
    Enum: "PENDING_FOR_FIRST_USE", "CREATED", "ACTIVE", "SUSPENDED", "EXPIRED"

  - `data.plan` (object, required)
    The plan details associated with this attachment

  - `data.plan.name` (string)
    The name of the plan
    Example: "Usa plan green 1gb 7 days"

  - `data.plan._id` (string)
    The unique identifier for the plan
    Example: "e90b8df8-fc8a-4010-8d70-13c756017747"

  - `data.plan.coverage_id` (string)
    The unique identifier for the coverage area
    Example: "24648a7f-8281-4af7-8fc0-19b2371b2d1d"

  - `data.plan.region_code` (string)
    The region code for the plan
    Example: "US"

  - `data.plan.label` (string)
    The label or tier of the plan
    Example: "Green"

  - `data.plan.throttling` (boolean)
    Indicates whether throttling is enabled for this plan

  - `data.plan.recurring` (boolean)
    Indicates whether this is a recurring plan

  - `data.plan.data_mega_bytes` (integer)
    The data allowance in megabytes
    Example: 1024

  - `data.plan.period_days` (integer)
    The duration of the plan in days
    Example: 7

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