> ## Documentation Index
> Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Wireless API errors

> Handle Wireless API failures for SIM lifecycle, ordering, network preferences, groups, data limits, and public IP allocation.

Wireless endpoints can return the standard Telnyx `errors` envelope as well as legacy or status-only responses. When the response includes `errors`, branch on `errors[].code` and use `errors[].detail` and `errors[].source` for diagnostics. For responses whose API reference does not define an `errors` envelope—such as some `401` and `404` responses—branch on the HTTP status instead; the body may be absent or use a legacy single-error shape.

```json theme={null}
{
  "errors": [
    {
      "code": "70007",
      "title": "SIM card doesn't have a SIM card group",
      "detail": "A SIM card cannot be enabled unless it's associated with a SIM card group."
    }
  ]
}
```

Authentication, authorization, missing-resource, rate-limit, and other general request failures can use the [general API error codes](/development/api-fundamentals/api-errors). Wireless validation failures can instead return product-specific codes such as `70002` and `70003`; use the response shape documented for the operation together with the Wireless code guidance below.

## Wireless error codes

| Code  | Title                                                        | Detail                                                                                                                                | Action                                                                                            |
| ----- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| 70000 | Consumption reached data limit                               | The consumption reached the defined data limit. Please, update the SIM card group data limit.                                         | Increase the SIM card group's data limit before retrying the operation.                           |
| 70001 | There aren't enough available SIM cards                      | Insufficient inventory to satisfy order request.                                                                                      | Reduce the requested quantity or retry when sufficient inventory is available.                    |
| 70002 | Invalid data format                                          | The provided data attribute was invalid.                                                                                              | Compare the rejected attribute with the endpoint's request schema, correct its format, and retry. |
| 70003 | Mobile operators' preferences priorities are out of sequence | The mobile operators' preferences priorities should be in an ascending order starting by 0.                                           | Renumber the priorities as a contiguous sequence beginning with `0`, then retry.                  |
| 70004 | OTA update in progress                                       | SIM card network preferences can't be defined when a previous OTA update is still in progress.                                        | Wait for the current OTA update to finish before changing network preferences.                    |
| 70005 | Could not delete SIM card group                              | The SIM card group associated with the provided ID can not be deleted because there are SIM cards associated with the SIM card group. | Move the associated SIM cards to another group before deleting this group.                        |
| 70006 | Could not delete default SIM card group                      | The SIM card group associated with the provided ID can not be deleted because it is the default SIM card group on your account.       | Do not retry deletion of the default group; select a non-default group for deletion.              |
| 70007 | SIM card doesn't have a SIM card group                       | A SIM card cannot be enabled unless it's associated with a SIM card group.                                                            | Assign the SIM card to a SIM card group, then retry the enable request.                           |
| 70008 | Public IPs are unavailable at this time                      | There aren't any public IPs available at this time. Please contact Telnyx support for more information.                               | Contact Telnyx support before retrying public IP allocation.                                      |

## Recovery pattern

1. Record the HTTP status, `errors[].code`, `errors[].detail`, and any `errors[].source` value.
2. Correct terminal request or resource-state errors before retrying. Repeating the same request does not resolve codes such as `70002`, `70003`, `70005`, `70006`, or `70007`.
3. For in-progress state (`70004`), wait for the existing OTA update to finish, then retry.
4. For capacity errors (`70001`, `70008`), change the request as described above or wait for availability; contact support when the error detail instructs you to do so.

See [SIM lifecycle](/docs/iot-sim/sim-lifecycle), [SIM card groups](/docs/iot-sim/sim-card-groups), [OTA updates](/docs/iot-sim/ota-updates), and [public IPs](/docs/iot-sim/public-ips) for the related workflows.