Messaging Workflows
Track Messages
Query the latest known state of one SMS order.
Overview
Use Track Messages to read the current state of a message order after Send SMS or Bulk Messaging creates it.
Endpoint
GET /api/v1/sms/orders/{order_id}
Authentication: Bearer access token.
Before You Begin
You need the order_id returned by FutureSMS. If your application uses a client reference, store the returned order_id with that reference.
Request fields
Path parameters:
| Name | Required | Example |
|---|---|---|
order_id | Yes | SDPS2603251030120000356 |
Response fields
| Field | Meaning |
|---|---|
order_id | FutureSMS business order identifier. |
client_order_id | Merchant-side reference, when provided. |
order_status | Order processing and billing state. |
message_status | Normalized delivery state, or null while not available. |
phone_number | Destination number in E.164 format. |
sender_value | Sender display value used for the message. |
content | Rendered SMS content. |
merchant_price_usd | Merchant price as a decimal string. |
dlr_address | Callback URL used for this order, when available. |
dlr_available | Whether delivery report information is available. |
created_at | UTC creation time. |
updated_at | UTC update time. |
Behavior
Order state and delivery state are separate. A message can be accepted for processing before final delivery information is available.
Status codes
| Status | Meaning |
|---|---|
200 | Order was found and returned. |
401 | Missing, invalid, or expired access token. |
403 | Authenticated caller is not allowed to view this order. |
404 | Order was not found or is not visible to the caller. |
422 | Path parameter validation failed. |
Examples
Delivered order
{
"message": "OK",
"details": null,
"data": {
"order_id": "SDPS260325103012A1B2C3D",
"client_order_id": "client-ord-20260325-0001",
"order_status": "charged",
"message_status": "DELIVRD",
"phone_number": "+639171234567",
"sender_value": "testsms",
"content": "Welcome to FutureSMS, Alice",
"merchant_price_usd": "0.000000",
"dlr_address": "https://merchant-a.example.com/dlr",
"dlr_available": true,
"created_at": "2026-03-25T10:30:12Z",
"updated_at": "2026-03-25T10:31:48Z"
},
"meta": null
}