list | SignalWire

List conference log entries.

Query parameters

include_deletedbooleanOptional

Include logs for deleted activity.

created_onstringOptional

Return logs for activity on this date. Accepts a date (YYYY-MM-DD) or ISO 8601 timestamp.

created_beforestringOptional

Return logs for activity prior to this date. Accepts a date (YYYY-MM-DD) or ISO 8601 timestamp.

created_afterstringOptional

Return logs for activity after this date. Accepts a date (YYYY-MM-DD) or ISO 8601 timestamp.

page_numberintegerOptional>=0Defaults to 0

The page number to retrieve (0-indexed).

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_tokenstringOptional

Token for cursor-based pagination. Required when `page_number` > 0.

Response

linksobjectRequired

Pagination links.

datalist of objectsRequired

A list of conference logs.

Response Example

Response

{
  "links": {
    "self": "https://example.signalwire.com/api/logs/conferences?page_number=0&page_size=50",
    "first": "https://example.signalwire.com/api/logs/conferences?page_size=50",
    "next": "https://example.signalwire.com/api/logs/conferences?page_number=1&page_size=50&page_token=PAb9028451-b1d3-4690-b5d3-37b19d25f573",
    "prev": "https://example.signalwire.com/api/logs/conferences?page_number=0&page_size=50&page_token=PBb9028451-b1d3-4690-b5d3-37b19d25f573"
  },
  "data": [
    {
      "created_at": "2025-03-11T01:49:49.630Z",
      "current_participants": 1,
      "id": "b9028451-b1d3-4690-b5d3-37b19d25f573",
      "max_size": 2,
      "name": "conference",
      "project_id": "a77ce7d0-6ae8-4b33-a7a6-0bf1750d1e19",
      "region": "us1",
      "status": "in-progress",
      "type": "cxml_conference",
      "updated_at": "2025-03-12T01:49:49.630Z"
    }
  ]
}

Example

from signalwire.rest import RestClient
client = RestClient(
    project="your-project-id",
    token="your-api-token",
    host="your-space.signalwire.com",
)
confs = client.logs.conferences.list()
for conf in confs.get("data", []):
    print(conf.get("name"), conf.get("status"))