Skip to content

API Error Codes

The following list of error codes will help you understand the errors you might be getting when calling our APIs

HTTP 400 Errors

Internal Error Code HTTP Error Code Error Message
1000 401 Request Authorization header is blank or no token is provided
1001 401 Token provided in the Authorization header is malformed
1002 401 Invalid token provided in the Authorization header or the user cannot access the resource
1003 400 Bearer missing from Authorization header
1004 401 The trial account is expired
1005 401 The number of requests has exceeded the limit assigned to this trial account
1006 401 Client ID provided has empty data
1007 401 Error occurred in AAT certificate validation
1020 400 Invalid CODE or Empty CODE for the token provided in the Authorization header
1021 401 Client ID provided has empty data
1022 417 Sending message failed to A2P
1023 400 PID is in hexadecimal
1024 400 Invalid Operator ID provided
1025 400 Validity period can be between 5m (where 'm' is minutes) to 1w (where 'w' is week). Single digit allowed.
Example: 5m, 4h (where 'h' is hours), 2d (where 'd' is days)
1026 400 Destination number provided is incorrect. It should be in the format + with maximum 15 digits (E.164 format)
1029 400 ASCII encoding is not supported
1030 400 The client ID {0} passed does not belong to client
1031 400 Page index {0} is invalid
1032 400 The parameter "{0}" is required and should be in yyyyMMddHHmm format.
For Example: 201709011230
1033 400 The parameter "{0}" is in invalid format. It should be in yyyyMMddHHmm format.
For Example: 201709011230
1034 400 The parameter "pageIndex" is required
1036 403 The provided credentials are not correct

HTTP 500 Errors

Internal Error Code HTTP Error Code Error Message
1008 500 Unable to resolve IP address of the AAT host
1009 503 Failed to connect to AAT
1010 503 Unable to generate access token
1011 503 Unable to validate access token
1012 503 Unable to invalidate access token
1013 500 Error occurred while processing request
1027 500 Unable to resolve IP address of the A2P host
1028 503 Failed to connect to A2P
1035 500 Hub Account details were not found