> 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.md).

# eSIMs

Manage eSIM inventory and package assignments.

| Identifier      | Meaning                                                                                                                     |
| --------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `esimId`        | Internal eSIM identifier from `data[].id` in `GET /api/v1/esims`, or the response from `POST /api/v1/esims/assign-package`. |
| `iccid`         | eSIM card identifier. Store the mapping `ICCID -> esimId`.                                                                  |
| `packageId`     | Catalog package identifier.                                                                                                 |
| `packageEsimId` | Identifier of one package assignment: `packageEsims[].id`. Use it for package usage requests.                               |

An eSIM can have multiple package assignments. Keep each assignment ID and evaluate its status, queue position, and usage fields.
