> For the complete documentation index, see [llms.txt](https://en-api.decisiontele.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://en-api.decisiontele.com/esim-api/remove-a-package.md).

# Remove a Package

Remove a data package from an existing eSIM without deleting the eSIM itself.

Use this operation when a package expires, needs to be replaced, was assigned incorrectly, or a subscription is cancelled.

#### Request

DELETE /api/v1/esims/remove-packages

```
curl --location --request DELETE \
"https://esim-api.it-decision.com/api/v1/esims/remove-packages" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <TOKEN>" \
--data '{
  "packageEsimIds": [
    "<PACKAGE_ESIM_ID>"
  ]
}'
```

#### Recommended Method

Use packageEsimIds when you want to remove a specific package-to-eSIM association.

#### Alternative Methods

* `combinations` — Remove specific `esimId` + `packageId` pairs.
* `esims + packages` — Remove all matching combinations between the provided eSIMs and packages.

#### Result

Only the package-to-eSIM association is removed.

{% hint style="info" %}
The eSIM is not deleted, the package is not deleted, and other packages assigned to the same eSIM are not affected.
{% endhint %}

The eSIM loses access only to the data allowance provided by the removed package.