Error handling

This page provides a comprehensive list of error codes that may be returned by the API during operation. Each error code is accompanied by a description of its meaning and potential causes, helping you to quickly identify and troubleshoot issues.

Error Code Structure

Code: A numeric or string identifier that categorizes the error.

Reason: A detailed explanation of the error, including additional context when applicable.

Use this reference to understand why a particular request failed and to implement appropriate handling in your application, ensuring a robust and reliable integration with the API.

Data eSIM Service Error Codes

Most Common API Error Codes

Code	HTTP Code	Reason
4001	400	Invalid input (malformed or missing data)
4004	429	Rate limit exceeded
4005	404	Resource not found
4007	402	Payment required (insufficient balance or credit)
4008	400	Bad request (invalid parameters or payload)
4009	401	Unauthorized (invalid or missing token)
4010	400	Validation error (business rule violation)
4013	401	Invalid token
4014	401	Token expired
4033	503	Temporarily unavailable (try again later)
5001	500	Internal server error

HTTP Status Codes

HTTP Code	Reason
400	Bad Request
401	Unauthorized
402	Payment Required
403	Forbidden
404	Not Found
409	Conflict
413	Payload Too Large
429	Too Many Requests
500	Internal Server Error
502	Bad Gateway
503	Service Unavailable
504	Gateway Timeout

Validation and Processing Errors (HTTP 422)

These errors occur when the request is well-formed but cannot be processed due to validation issues or other business rules.

Code	Reason
11	Insufficient Credit: {additional}
13	The requested operator is currently undergoing maintenance. Please try again later.
14	Invalid checksum: {additional}
23	The requested top-up has been disabled by the operator. {additional}
33	Insufficient stock of eSIMs remaining: {additional}. Please try your request again later.
34	The requested eSIM package is invalid or it is currently out of stock. Please try again later.
43	Bad request. {additional} Please check your input and try again.
53	Something unexpected happened. We're working to resolve the issue. Please try again later.
73	The eSIM with iccid {additional} has been recycled. It can no longer be used or topped up.

Data eSIM Service Error Codes#

Most Common API Error Codes#

HTTP Status Codes#

Validation and Processing Errors (HTTP 422)#

Data eSIM Service Error Codes

Most Common API Error Codes

HTTP Status Codes

Validation and Processing Errors (HTTP 422)