# Delete a Subscription

Deletes the subscription and recycles the ICCID associated with it. The associated ICCID goes back into the customer inventory and will be picked up again automatically in the creation of a new subscription at some point in time in future.

 Note: this operation will fail if the esim profile associated with the ICCID was ever downloaded by an end-user.

Endpoint: DELETE /v3/subscriptions/{iccid}
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

  - `message` (string, required)
    A message indicating the result of the delete operation
    Example: "Subscription deleted successfully"

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

## Response 403 fields (application/json):

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

  - `message` (string, required)
    A message indicating the reason for the unauthorized delete response
    Example: "Cannot delete a subscription whose esim was installed on a device"