curl https://api.tracklysms.com/api/v2/messages/a1b2c3d4 \
-H "X-Api-Key: trk_your_api_key"
{
"message": {
"id": "a1b2c3d4",
"from_number": "+18005551234",
"to_number": "+14155551234",
"body": "Hi",
"status": "delivered",
"segment_count": 1,
"encoding": "GSM-7",
"sending_list_id": 88,
"timestamp": "2026-07-20T14:03:11.000000Z",
"updated_at": "2026-07-20T14:05:00.000000Z",
"dlr_status": "delivered",
"is_terminal": true,
"is_delivered": true,
"provider_message_id": "O3iFf1Eu",
"cost_state": "billed",
"external_ids": { "external_location_id": "loc_west" }
}
}
{ "error": "Message not found", "code": "message_not_found" }
Messages (v2)
Get Message
Fetch a single sent message by its ID.
GET
/
v2
/
messages
/
{messageId}
curl https://api.tracklysms.com/api/v2/messages/a1b2c3d4 \
-H "X-Api-Key: trk_your_api_key"
{
"message": {
"id": "a1b2c3d4",
"from_number": "+18005551234",
"to_number": "+14155551234",
"body": "Hi",
"status": "delivered",
"segment_count": 1,
"encoding": "GSM-7",
"sending_list_id": 88,
"timestamp": "2026-07-20T14:03:11.000000Z",
"updated_at": "2026-07-20T14:05:00.000000Z",
"dlr_status": "delivered",
"is_terminal": true,
"is_delivered": true,
"provider_message_id": "O3iFf1Eu",
"cost_state": "billed",
"external_ids": { "external_location_id": "loc_west" }
}
}
{ "error": "Message not found", "code": "message_not_found" }
Returns one message belonging to the calling account. The result is always scoped to the key’s own account.
Requires
Also
messages.read. Trial IDs beginning with trial_ use this same endpoint. Trial rows add trial: true, trial_campaign_id and queue_reason; cost_state is free, sending_list_id is null and from_number stays null before submission. Unknown transport reports error_code: "trial_submission_unknown_delivery_unconfirmed" and unconfirmed delivery; do not infer non-delivery or automatically resend. A later receipt can reconcile that uncertainty. See the trial guide.
Path Parameters
The opaque message ID returned by the send endpoint. Treat it as a variable-length string.
Response Fields
The message row — same shape as a row in List Messages.
Examples
curl https://api.tracklysms.com/api/v2/messages/a1b2c3d4 \
-H "X-Api-Key: trk_your_api_key"
{
"message": {
"id": "a1b2c3d4",
"from_number": "+18005551234",
"to_number": "+14155551234",
"body": "Hi",
"status": "delivered",
"segment_count": 1,
"encoding": "GSM-7",
"sending_list_id": 88,
"timestamp": "2026-07-20T14:03:11.000000Z",
"updated_at": "2026-07-20T14:05:00.000000Z",
"dlr_status": "delivered",
"is_terminal": true,
"is_delivered": true,
"provider_message_id": "O3iFf1Eu",
"cost_state": "billed",
"external_ids": { "external_location_id": "loc_west" }
}
}
{ "error": "Message not found", "code": "message_not_found" }
Error Codes
| HTTP Status | Error Code | Description |
|---|---|---|
| 404 | message_not_found | No message with that ID under this account. |
401 invalid_credentials.