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

# Statuses

Interpret status fields in their own context. Catalog availability, eSIM allocation, technical assignment status, and usage state describe different aspects of the service.

| Context                  | Field                        | Meaning                                       | Example          |
| ------------------------ | ---------------------------- | --------------------------------------------- | ---------------- |
| Package catalog          | `status`                     | Product status in the catalog.                | `live`           |
| Package catalog          | `active`                     | Product availability flag.                    | `true`           |
| eSIM listing             | `allocated` query filter     | Selects allocated or unallocated inventory.   | `true` / `false` |
| Package assignment       | `packageEsims[].status`      | Technical status of the package assignment.   | `active`         |
| Package assignment       | `packageEsims[].usageStatus` | Reported usage state of the assigned package. | `In Use`         |
| Dedicated usage response | `package.status`             | Technical assignment status.                  | `active`         |
| Dedicated usage response | `package.package_status`     | Reported package usage state.                 | `In Use`         |

These are example values, not an exhaustive list of status enums. Preserve returned values and handle unfamiliar values safely in your integration.

A technical assignment status such as `active` does not replace the usage state or validity dates. Evaluate status together with `usageStartAt`, `usageExpireAt`, `usageValue`, and `queuePosition` when selecting the relevant assignment.

Use `usageStatus` or `package_status` for the reported usage state. Do not present the catalog status or assignment status as if it were the eSIM’s mobile-network registration state.
