Get message activities

Retrieves the activity log for a specific message. Activities track the message lifecycle including acceptance, processing, sending, delivery, and any errors. A SCHEDULED entry carries scheduled_at, the release instant in UTC as it stood at that moment. Other entries have no scheduled_at key.

GET
/v3/messages/{id}/activities

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v3/messages/8ba7b830-9dad-11d1-80b4-00c04fd430c8/activities"
{
  "success": true,
  "data": {
    "message_id": "8ba7b830-9dad-11d1-80b4-00c04fd430c8",
    "activities": [
      {
        "status": "DELIVERED",
        "description": "Message delivered to recipient",
        "from": "+15551234567",
        "timestamp": "2026-09-30T13:48:13.6029504+00:00",
        "scheduled_at": null,
        "reason_code": null,
        "reason": null,
        "price": "0.0450",
        "active_contact_price": "0.0050"
      },
      {
        "status": "SENT",
        "description": "Message sent via SMS",
        "from": "+15551234567",
        "timestamp": "2026-09-30T13:43:13.6029788+00:00",
        "scheduled_at": null,
        "reason_code": null,
        "reason": null,
        "price": "0.0450",
        "active_contact_price": "0.0050"
      },
      {
        "status": "PROCESSED",
        "description": "Message processed and queued for sending",
        "from": null,
        "timestamp": "2026-09-30T13:42:13.602979+00:00",
        "scheduled_at": null,
        "reason_code": null,
        "reason": null,
        "price": "0.0450",
        "active_contact_price": "0.0050"
      },
      {
        "status": "QUEUED",
        "description": "Message accepted and queued for processing",
        "from": null,
        "timestamp": "2026-09-30T13:41:13.6029792+00:00",
        "scheduled_at": null,
        "reason_code": null,
        "reason": null,
        "price": null,
        "active_contact_price": null
      }
    ],
    "pagination": null
  },
  "error": null,
  "meta": {
    "request_id": "req_7X9zKp2jDw",
    "timestamp": "2026-09-30T14:13:13.6029871+00:00",
    "version": "v3"
  }
}
{
  "success": true,
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": [
        "string"
      ],
      "property2": [
        "string"
      ]
    },
    "doc_url": "string"
  },
  "meta": {
    "request_id": "string",
    "timestamp": "2019-08-24T14:15:22Z",
    "version": "string"
  }
}
Empty
Empty
{
  "success": false,
  "data": null,
  "error": {
    "code": "RESOURCE_003",
    "message": "Message not found",
    "details": null,
    "doc_url": "https://docs.sent.dm/reference/api/error-catalog"
  },
  "meta": {
    "request_id": "req_7X9zKp2jDw",
    "timestamp": "2026-09-30T14:13:13.6029893+00:00",
    "version": "v3"
  }
}
{
  "success": false,
  "data": null,
  "error": {
    "code": "INTERNAL_001",
    "message": "An unexpected error occurred while retrieving message activities.",
    "details": null,
    "doc_url": "https://docs.sent.dm/reference/api/error-catalog"
  },
  "meta": {
    "request_id": "req_7X9zKp2jDw",
    "timestamp": "2026-09-30T14:13:13.6029897+00:00",
    "version": "v3"
  }
}

Get message status GET

Retrieves the current status and details of a message by ID. Includes delivery status, timestamps, and error information if applicable.

List conversation messages GET

Retrieves a paginated list of the authenticated customer's messages across all conversations, ordered by created date (most recent first).