Other API endpoints
Last updated
Was this helpful?
Last updated
Was this helpful?
Here are some other potentially useful endpoints you can use.
If you are given a textId and want to check its delivery status, send an HTTP GET request to https://textbelt.com/status/:textId
.
For example, 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:
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 can be retrieved up to 1 week after the message was sent.
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".
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 https://textbelt.com/quota/:key
.
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:
For example, if you key is abc123
, just load in your browser or programmatically: