Sign in
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

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 changes found, but 3 of the 137 revisions have a changelog that could not be searched — this endpoint may have changed in one of them.