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

# eSIM API

Provision, activate, and manage eSIMs and data packages using the DecisionTelecom eSIM API.

The eSIM API supports client creation, eSIM allocation, compatible package assignment, activation data retrieval, top-ups, usage monitoring, package removal, and release of eSIMs.

### API reference

| Section          | Contents                                                                          |
| ---------------- | --------------------------------------------------------------------------------- |
| Authentication   | Base URL and request headers.                                                     |
| Packages         | List Packages and client-specific catalog prices.                                 |
| eSIMs            | Inventory, assigned packages, identifiers, assignment, and management guides.     |
| Usage            | Package usage requests, field mappings, remaining data, and multiple assignments. |
| Statuses         | Catalog, allocation, assignment, and usage status context.                        |
| Integration Flow | Recommended catalog, provisioning, and usage synchronization sequence.            |

### Management guides

* **Provision an eSIM**: create a B2C client, select an available eSIM, find compatible packages, assign the eSIM and package, and retrieve activation data.
* **Top Up an eSIM**: add a package to an existing eSIM.
* **Remove a Package**: remove a package assignment.
* **Release an eSIM**: unassign an eSIM from its client.

Open the corresponding page from the eSIM API navigation.