Search Results

Resource Status Codes

API Version: v4

Message Status

Status Codes

Status CodeStatus NameStatus DescriptionRequirements
10000PendingThe message has not yet been processed
20000Queued/ProcessingThe message has been queued and is in process
30000Sent/En-RouteThe message has been processed and has completed
30003ErrorAn error occurred while processing this message.
30004FilteredThis message was blocked by SPAM filters.
40000AcceptedThe message was confirmed as accepted by the destination operatorRegistered Delivery Requested
40001DeliveredThe message was confirmed as delivered by the destination operatorRegistered Delivery Requested

Error Codes

Error CodeError Description
E100001Security credentials not provided in request
E100002Security credentials invalid/disabled
E100003Account inactive, disabled or suspended
E100004Firewall IP Address not whitelisted
E100005Permission to requested resource not allowed
E200001Required parameters missing in request
E200002Invalid source address specified
Missing/invalid parameters
E200003Invalid request method for resource
E500001Message send fail
E500002Number is not in a registered state to route message

Message State

The message state value represents the current state of a message. The values may include any of the following.

State NameState Description
ENROUTEMessage is in an enroute state
DELIVRDMessage is delivered to destination
EXPIREDMessage validity period has expired
DELETEDMessage has been deleted
ACCEPTDMessage is in accepted state
UNDELIVMessage is undeliverable
UNKNOWNMessage is in invalid state
REJECTDMessage is in a rejected state

Numbers Lookup

Upon a successful request, i.e. HTTP Status Code 200 or 202, the following “one plus six digit” API specific status codes will be presented within the response schema. (example: E000000)

Response Example

JSON Response

aerialink : {
errorCode: "EXXXXXX",
detail: "Invald Source Address Specified."
}

XML Response

<?xml version="1.0" encoding="UTF-8"?>
<aerialink>
<errorCode>EXXXXXX</errorCode>
<detail>Description of the error.</detail>
</aerialink>

Error Codes

Error CodeError DepartmentError NameError Description
E200001Parameter ValidationForbiddenRequired parameters were not provided in the request
E300001Data FormatBad RequestNumbers parameter value format is invalid
E300002Data FormatBad RequestCache parameter value format is invalid
E300003Data FormatBad RequestCallbackURL is not a valid HTTP url
E400001ContentBad RequestThe value of one or more parameters exceeds the maximum allowed content length or type

Send and Receive SMS

Upon a successful request, i.e. HTTP Status Code 200 or 202, the following “one plus six digit” API specific status codes will be presented within the response schema. (example: E000000)

Response Example

JSON Response

aerialink : {
errorCode: "EXXXXXX",
detail: "Invald Source Address Specified."
}

XML Response

<?xml version="1.0" encoding="UTF-8"?>
<aerialink>
<errorCode>EXXXXXX</errorCode>
<detail>Description of the error.</detail>
</aerialink>

Error Codes

Error CodeError DepartmentError NameError Description
E200001Parameter ValidationForbiddenRequired parameters were not provided in the request
E300001Data FormatBad RequestParameter value format is invalid
E400001ContentBad RequestThe value of one or more parameters exceeds the maximum allowed content length or type