Wireless API errors

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.

{
  "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. 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

Record the HTTP status, errors[].code, errors[].detail, and any errors[].source value.
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.
For in-progress state (70004), wait for the existing OTA update to finish, then retry.
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, SIM card groups, OTA updates, and public IPs for the related workflows.

Configuration

Monitoring & Troubleshooting

Device Guides

For AI Agents

Wireless API errors

Wireless error codes

Recovery pattern

​Wireless error codes

​Recovery pattern

Wireless error codes

Recovery pattern