---
title: "List Webinar Recordings (Admin)"
method: GET
path: "/webinar/history/v1/company/recordings"
tags: ["Historical Recordings"]
---

# List Webinar Recordings (Admin)

`GET /webinar/history/v1/company/recordings`

## Request

- Base URL: `https://platform.ringcentral.com`
- URL: `https://platform.ringcentral.com/webinar/history/v1/company/recordings`
- Auth: OAuth 2
  - Authorization code: `https://platform.ringcentral.com/restapi/oauth/authorize`
  - Token URL: `https://platform.ringcentral.com/restapi/oauth/token`
- TypeScript: <https://skmtc.dev/ringcentral/apis/ringcentral-api/docs/webinar/history/v1/company/recordings/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the list of webinar recordings (Administrator's interface).
The user must have "WebinarSettings" permission granted otherwise the API returns HTTP 403.

## Query parameters

- `nameFragment` string
- `creationTimeFrom` string, date-time, required
- `creationTimeTo` string, date-time, required
- `status` RecordingStatusModel[]
- `hostUserId` string[]
- `perPage` integer
- `pageToken` string

## Response `200`

Successful response

- RecordingAdminListResource
  - `records` RecordingAdminModel[], required
    - `id` string: Internal object ID
    - `creationTime` string, date-time, required: Object creation time
    - `lastModifiedTime` string, date-time, required: Object last modification time
    - `status` 'Processing' | 'Available' | 'Failed' | 'Purged', required: Recording status
    - `failureReason` ApiError: Generalized API error structure suitable for any error type
      - `errorCode` string, required: Logical error code (typically, 3 letters followed with number, dash separated)
      - `message` string, required: User-friendly error message
    - `duration` integer: Recording duration in seconds
    - `shared` boolean: Indicates if Host or Admin has shared a recording. Can be set to true only then recording status is 'Available'.
    - `sharedUriExpirationTime` string, date-time, nullable: Time after which recording shared link cannot be accessed by recipients.
    - `session` object
      - `id` string: Internal object ID
      - `startTime` string, date-time: Session start time. If a session hasn't been started this fields should be set to "scheduledStartTime"
      - `endTime` string, date-time: Session end time. If a session hasn't been finished this fields should be set to ("startTime"+"scheduledDuration")
      - `duration` integer: Session duration in seconds rounded up (returned if 'startTime' and 'endTime' are not empty)
      - `title` string: Session title. If blank - derived from webinar title.
      - `description` string: User-friendly description of the Session. If blank - derived from webinar title.
      - `webinar` WebinarRefModel
        - `id` string: Internal object ID
        - `title` string, required: Webinar title
        - `description` string: User-friendly description of the Webinar
        - `host` HostModel, required: The internal IDs of RC-authenticated users.
          - `firstName` string: First (given) name
          - `lastName` string: Last (family) name
          - `linkedUser` RcwDomainUserModel
            - `userId` string, required: User ID
            - `accountId` string, required: Account ID
            - `domain` 'pbx' | 'ilm', required: Identity domain
  - `paging` RcwPagingModel, required
    - `perPage` integer, required: Number of items per page
    - `pageToken` string, required: Current page token
    - `nextPageToken` string: Next page token (absent for the last page of the result set)
    - `previousPageToken` string: Previous page token (absent for the first page of the result set)

## Other responses

- `400`: General response with **HTTP 400 "Bad request"** status.<br> Reasons: unparsable request, path, query or body parameters are invalid. The error description may contain reference to particular parameter(s) which haven't passed the validation.
- `403`: General response with **HTTP 403 "Forbidden"** status.<br> Reasons: the requested operation is forbidden because of certain resource state, lack of permissions, feature unavailability, etc.
- `500`: General response with **HTTP 500 "Internal Server Error"** status.<br> Reasons: general server-side error.

---

[API](https://skmtc.dev/ringcentral/apis/ringcentral-api.md) - [All operations](https://skmtc.dev/ringcentral/apis/ringcentral-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ringcentral/apis/ringcentral-api/revisions/8d602198ec97?raw)