Other API endpoints

Here are some other potentially useful endpoints you can use.

Checking SMS delivery status

If you are given a textId and want to check its delivery status, send an HTTP GET request to
For examepl, if you textId is 12345, go to in your browser or load it programmatically:
The response is a JSON object that contains a single status field. For example:
{"status": "DELIVERED"}
Possible return values include:
  • DELIVERED - Carrier has confirmed sending
  • SENT - Sent to carrier but confirmation receipt not available
  • SENDING - Queued or dispatched to carrier
  • FAILED - Not received
  • UNKNOWN - Could not determine status
Delivery statuses are not standardized between mobile carriers. Some carriers will report SMS as "delivered" when they attempt transmission to the handset while other carriers actually report delivery receipts from the handsets. Some carriers do not have a way of tracking delivery, so all their messages will be marked "SENT".

Checking your credit balance

You may want to know how much quota or credit you have left on a key. You check this by sending an HTTP GET request to
For example, if you key is abc123, just load in your browser or programmatically:
The response contains a JSON object with two attributes:
  • success: Whether or not we were able to look up this key
  • quotaRemaining: The amount of SMS credit remaining on this key
For example:
{"success": true, "quotaRemaining": 98}