---
title: "List video logs"
method: GET
path: "/api/video/logs"
tags: ["Video Logs"]
---

# List video logs

`GET /api/video/logs`

List the available logs.

#### Permissions

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

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Query parameters

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

## Response `200`

The request has succeeded.

- VideoListLogsResponse — List logs response.
  - `links` VideoPaginationLinks, required — Pagination links for 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.
    - `prev` string — Link to the previous page.
  - `data` VideoVideoLog[], required — List of logs.
    - union — A video log entry. Discarded logs return only `id`, `discarded_at`, and `created_at`.
      - VideoLog — Log object representing a video activity entry.
        - `id` string, uuid, required — Universal Unique Identifier.
        - `source` 'realtime_api', required — Source of a video log entry.
        - `type` 'video_room_session' | 'video_conference_session', required — Type of video activity recorded in the log.
        - `url` string, required — URL for the resource associated with this log entry.
        - `room_name` string, nullable, required — A named unique identifier for the room.
        - `status` 'in-progress' | 'completed', required — Status of a video room session.
        - `locked` boolean, required — Whether the room session is locked.
        - `started_at` string, date-time, nullable, required — Start time of the activity.
        - `ended_at` string, date-time, nullable, required — End time of the activity.
        - `charge` number, double, required — Charge amount for this activity, in dollars.
        - `created_at` string, date-time, required — Timestamp when the log was created.
        - `charge_details` VideoChargeDetail[], required — Details on charges associated with this log.
          - `description` string, required — Description for this charge.
          - `charge` number, double, required — Charged amount, in dollars.
      - VideoDiscardedLog — A discarded/deleted video log entry. Returned when the log has been deleted. Only present when `include_deleted` is `true`.
        - `id` string, uuid, required — Universal Unique Identifier.
        - `discarded_at` string, date-time, required — Date and time when the log was discarded.
        - `created_at` string, date-time, required — Date and time when the log was originally created.

## Other responses

- `400` — The request is invalid.
- `401` — Access is unauthorized.
- `403` — Access is forbidden.
- `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)