API Response Codes

The API returns the following HTTP status codes.

200 OK

The request was accepted and processed successfully.

Example response:

{
  "transactionID": "request-id",
  "messageID": [
    "message-id-1",
    "message-id-2"
  ]
}

500 Internal Server Error

The request could not be completed. The response body includes an error field with a short description.

Possible error messages are:

{ "error": "Missing destinations field" }

{ "error": "Empty destinations field" }

{ "error": "Number of destinations exceeds limit (max 100 destinations)" }

{ "error": "Unable to connect" }

{ "error": "Unable to bind" }

Notes:

• A successful API response confirms that the request was accepted by the upstream messaging system and includes the returned message identifier or identifiers.
• Provider-specific SMPP status codes are not exposed directly in the API response.
• An empty messageID field indicates that the message submission was rejected (SubmitSMResp error received).
• Invalid or incomplete request bodies may result in an error response if required fields are missing or cannot be processed.