---
title: "Get video log"
method: GET
path: "/api/video/logs/{id}"
tags: ["Video Logs"]
---

# Get video log

`GET /api/video/logs/{id}`

Find a log by ID.

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

## Path parameters

- `id` string, uuid, required — Universal Unique Identifier.

## Response `200`

Response model for video log retrieve endpoint.

- 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.
- `404` — The server cannot find the requested resource.
- `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)