> 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/esims/assign-package.md).

# Assign Package

Assign a compatible package to an eSIM and keep the identifiers returned by the assignment operation.

### Before assignment

| Identifier  | How to obtain it                                                               |
| ----------- | ------------------------------------------------------------------------------ |
| `clientId`  | Create the B2C client as described in **Provision an eSIM**.                   |
| `esimId`    | Use `data[].id` from `GET /api/v1/esims`.                                      |
| `packageId` | Select a compatible package using the package lookup in **Provision an eSIM**. |

### Assignment operation

```http
POST /api/v1/esims/assign-package
Authorization: Bearer <TOKEN>
Content-Type: application/json
Accept: application/json
```

The assignment response returns the assigned eSIM ID and ICCID. Store the mapping `ICCID -> esimId`. The complete provisioning sequence is documented in **Provision an eSIM**.

### Retrieve the assignment identifier

After assignment, retrieve the allocated eSIMs with packages:

```http
GET /api/v1/esims?scopeBy=package&allocated=true&page=1&perPage=100
Authorization: Bearer <TOKEN>
Accept: application/json
```

Use the relevant `packageEsims[].id` as `packageEsimId`. Store it for usage monitoring. Assignment does not by itself establish the actual package activation date; use `usageStartAt` and `usageExpireAt` for validity on the eSIM.

For additional packages on an existing eSIM, see **Top Up an eSIM**. For usage selection when several assignments exist, see **Multiple Packages on One eSIM**.
