API documentation

GET /text_messages/:id

Authorization Required

https://[your-subdomain].trackdrive.com/api/v1/text_messages/:id

Get a text message request

Returns a single outgoing text message by id, including its current delivery status. Restricted to account superusers and requires the text_messages permission.

Example Request

curl 'https://[your-subdomain].trackdrive.com/api/v1/text_messages/10001' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "text_message": {
    "id": 10001,
    "type": "TextMessage",
    "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": null,
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": "/text_messages/10001",
    "routes_edit_path": "/text_messages/10001/edit",
    "external_record_id": null,
    "from": "+1900000005@sip1018927104081",
    "to": "+18005550123",
    "message": "Thanks for your submission! A representative will call in 60 seconds.",
    "name": "From +1900000005@sip1018927104081 To +18005550123",
    "number_id": 10002,
    "lead_id": null,
    "provider_configuration_id": 10003,
    "message_uuid": null,
    "destination_caller_id": "+18005550123",
    "status": "sent",
    "error_code": null,
    "ring_pool_id": null,
    "schedule_id": null,
    "sent_at": null,
    "manual": false,
    "contact_id": null,
    "delivery_webhook_url": null,
    "text_message_flow_id": null
  },
  "metadata": {
    "root": "text_message"
  }
}