---
title: "List conference logs"
method: GET
path: "/api/logs/conferences"
tags: ["Conference Logs"]
---

# List conference logs

`GET /api/logs/conferences`

A list of Conferences.

#### 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).

## Query parameters

- `include_deleted` boolean
- `created_on` string
- `created_before` string
- `created_after` string
- `page_number` integer
- `page_size` integer
- `page_token` string

## Response `200`

The request has succeeded.

- LogsConferencesResponse — Response containing a list of conferences.
  - `links` LogsConferenceLogPaginationLinks, required — Pagination links for conference log list responses.
    - `self` string, required — Link to the current page.
    - `first` string, required — Link to the first page.
    - `next` string — Link to the next page. Only present when there are more results.
    - `prev` string — Link to the previous page. Only present when not on the first page.
  - `data` union[], required — A list of conference logs.
    - union
      - LogsCxmlConference — Core conference object.
        - `id` string, uuid, required — Universal Unique Identifier.
        - `created_at` string, date-time, required — Creation timestamp.
        - `project_id` string, uuid, required — Universal Unique Identifier.
        - `region` string, required — Region of the conference.
        - `name` string, nullable, required — Name of the conference.
        - `status` string, nullable, required — Status of the conference.
        - `max_size` integer, nullable, required — Maximum size of the conference.
        - `current_participants` integer, required — Current participants in the conference.
        - `updated_at` string, date-time, required — Updated timestamp.
        - `type` 'cxml_conference', required — Type of the conference.
      - LogsRelayConference — Core conference object.
        - `id` string, uuid, required — Universal Unique Identifier.
        - `created_at` string, date-time, required — Creation timestamp.
        - `project_id` string, uuid, required — Universal Unique Identifier.
        - `region` string, required — Region of the conference.
        - `name` string, nullable, required — Name of the conference.
        - `status` string, nullable, required — Status of the conference.
        - `max_size` integer, nullable, required — Maximum size of the conference.
        - `current_participants` integer, required — Current participants in the conference.
        - `updated_at` string, date-time, required — Updated timestamp.
        - `type` 'relay_conference', required — Type of the conference.
        - `recording_url` string, nullable, required — Recording URL of the conference.
        - `recording_duration` integer, nullable, required — Recording duration of the conference.
        - `recording_file_size` integer, nullable, required — Recording file size of the conference.
      - LogsVideoRoomSessionConference — Core conference object.
        - `id` string, uuid, required — Universal Unique Identifier.
        - `created_at` string, date-time, required — Creation timestamp.
        - `source` string, required — Source of the conference.
        - `type` 'video_conference_session' | 'video_room_session', required — Type of the conference.
        - `url` string, required — URL of the conference room session.
        - `room_name` string, nullable, required — Name of the conference room.
        - `status` string, nullable, required — Status of the conference.
        - `locked` boolean, required — Whether the conference is locked.
        - `started_at` string, date-time, nullable, required — Timestamp when the conference started.
        - `ended_at` string, date-time, nullable, required — Timestamp when the conference ended.
        - `charge` string, required — Total charge amount of the conference in dollars.
        - `charge_details` LogsChargeDetails[], required — Details on charges associated with this conference.
          - `description` string, required — Description for this charge.
          - `charge` string, required — Charge amount in dollars.

## Other responses

- `401` — Access is unauthorized.
- `422` — The request contains invalid parameters. See errors for details.
- `500` — An internal server error occurred.

---

[API](https://skmtc.net/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.net/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signalwire/signalwire-rest-api/versions/05c5164b85c7/schema)