Voice Logs

List voice logs

Lists historical voice activity in the project across supported call types. Use it for usage reporting, billing review, and troubleshooting, not live call control. Place or control calls through Send call commands or the Compatibility Calls API instead.

Permissions

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

Learn more about API scopes.

get/api/voice/logs

Request

  • Base URL
    https://{Your_Space_Name}.signalwire.com
  • URL
    https://{Your_Space_Name}.signalwire.com/api/voice/logs
  • Auth
    HTTP basic

Query parameters

include_deletedboolean

Include logs for deleted activity.

created_beforestring

Return logs for activity prior to this date.

created_onstring

Return logs for activity on this date.

created_afterstring

Return logs for activity after this date.

page_numberinteger

Page number to return. Requires page_token for values greater than 0.

page_sizeinteger

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

page_tokenstring

Token for cursor-based pagination. Required when page_number is greater than 0.

Response

The request has succeeded.

Example response

{
  "links": {
    "self": "https://example.signalwire.com/api/voice/logs?page_number=0&page_size=50",
    "first": "https://example.signalwire.com/api/voice/logs?page_size=50",
    "next": "https://example.signalwire.com/api/voice/logs?page_number=1&page_size=50&page_token=PA2fa20774-64a1-41d3-a88a-1c61f563d0e7",
    "prev": "https://example.signalwire.com/api/voice/logs?page_number=0&page_size=50&page_token=PA2fa20774-64a1-41d3-a88a-1c61f563d0e7"
  },
  "data": [
    {
      "from": "+12065551212",
      "to": "+12065553434",
      "charge": 0.01,
      "charge_details": [],
      "created_at": "2024-05-06T12:20:00Z",
      "duration": 9,
      "duration_ms": 9638,
      "billing_ms": 60000
    }
  ]
}

Changes

No operation changes found yet. Some revisions have not been checked.