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

# Usage

Monitor data allowance, consumption, remaining data, validity dates, and status for each package assigned to an eSIM.

The eSIM list with `scopeBy=package&allocated=true` includes assignment usage fields. For the latest details of a specific assignment, call `POST /api/v1/packages/usage` using `packageEsims[].id` as `packageEsimId`.

| Page                          | Purpose                                                     |
| ----------------------------- | ----------------------------------------------------------- |
| Get Package Usage             | Request usage for one assignment.                           |
| Usage Fields                  | Map allowance, consumption, dates, and status fields.       |
| Remaining Data                | Calculate the unused allowance in consistent units.         |
| Multiple Packages on One eSIM | Select the relevant assignment when several packages exist. |

Usage is near real-time. Mobile-network reporting may introduce a short delay after the latest data session.
