List message logs

GET

https://{your_space_name}.signalwire.com/api/messaging/logs

GET

/api/messaging/logs

curl https://{your_space_name}.signalwire.com/api/messaging/logs \
     -u "<project_id>:<api_token>"

{
  "links": {
    "self": "https://example.signalwire.com/api/messaging/logs?page_number=0&page_size=50",
    "first": "https://example.signalwire.com/api/messaging/logs?page_size=50",
    "next": "https://example.signalwire.com/api/messaging/logs?page_number=1&page_size=50&page_token=PA6ad4c839-9329-43fe-83c6-fbe7c38583ff",
    "prev": "https://example.signalwire.com/api/messaging/logs?page_number=0&page_size=50&page_token=PA6ad4c839-9329-43fe-83c6-fbe7c38583ff"
  },
  "data": [
    {
      "id": "string",
      "from": "+12077447397",
      "to": "+12029921413",
      "status": "failed",
      "direction": "inbound",
      "kind": "sms",
      "source": "laml",
      "type": "relay_message",
      "url": "https://example.signalwire.com/api/laml/2010-04-01/Accounts/c38dacad-2f6c-4de1-93d6-cc732e0c70c5/Messages/9ee38635-899a-490a-bfd1-9e72f5eea53c",
      "number_of_segments": 1,
      "charge": 0,
      "charge_details": [
        {
          "description": "Inbound SMS",
          "charge": 0.00415
        }
      ],
      "created_at": "2024-05-06T12:20:00Z",
      "error_message": "From number is not a SMS-capable phone number.",
      "error_code": "21601"
    }
  ]
}

Lists historical messaging activity in the project for delivery review, auditing, and troubleshooting. This collection is read-only; send or redact messages through the Messages API instead.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Messaging.

Learn more about API scopes.

Authentication

AuthorizationBasic

SignalWire Basic Authentication using Project ID and API Token.

The client sends HTTP requests with the Authorization header containing the word Basic followed by a space and a base64-encoded string of project_id:token. The project ID will be used as the username and the API token as the password.

Example:

Authorization: Basic base64(project_id:token)

Query parameters

include_deletedbooleanOptionalDefaults to false

Include logs for deleted activity.

created_beforestringOptional

Return logs for activity prior to this date.

created_onstringOptional

Return logs for activity on this date.

created_afterstringOptional

Return logs for activity after this date.

page_sizeintegerOptional1-1000Defaults to 50

Specify the number of results to return on a single page. The default page size is 50 and the maximum is 1000.

page_numberintegerOptional>=0Defaults to 0

Page number to retrieve. Requires page_token when greater than 0.

page_tokenstringOptional

Token for cursor-based pagination. Required when page_number is greater than 0. The token is returned in pagination links.

Response

The request has succeeded.

linksobject

Object containing pagination links

datalist of objects

Array of message log entries

Errors

400

Bad Request Error

401

Unauthorized Error

422

Unprocessable Entity Error

500

Internal Server Error