List conference logs

GET

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

GET

/api/logs/conferences

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

{
  "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"
    }
  ]
}

Permissions

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

Learn more about API scopes.

Lists historical voice conferences and Video Room or Conference sessions across the project. Use it for usage reporting and auditing across conference types, not for live control. Use Compatibility [Conferences](/docs/compatibility-api/rest/conferences/list-all-conferences) to inspect or control live voice conferences, or [Video Conferences](/docs/apis/rest/video/video-conferences/list-video-conferences) to manage hosted video conference configurations. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_ or _Video_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space).

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)

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_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

The request has succeeded.

linksobject

Pagination links.

datalist of objects

A list of conference logs.

Errors

401

Unauthorized Error

422

Unprocessable Entity Error

500

Internal Server Error