---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.com/dev/direct/doc/en/advideos/get.md
  - https://yandex.com/dev/direct/doc/ru/advideos/get.md
sourcePath: en/ref-v5/advideos/get.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/en/llms.txt

# get

Returns the status of processing uploaded videos.

## Request

Request structure in JSON format.

```javascript
{
   "method": "GetRequest",
   "params" : { /* required */
        "Page" : {
            "Limit" : (long),
            "Offset" : (long)
        },
        "SelectionCriteria" : { /* required */
            "Ids" : [ (string) ] /* required */
        },
        "FieldNames" : [ ("Id"|"Status") ] /* required */
    }
}
```

#|
|| **Parameter**  | **Type**  | **Description**  | **Required** ||

|| **params structure (for JSON) / GetRequest (for SOAP)** | > | > | > ||

|| `Page` | LimitOffset | Structure that defines the page for [paginated selection](https://yandex.com/dev/direct/doc/dg/best-practice/get.html) of data.  | Yes ||

|| `SelectionCriteria` | AdVideosSelectionCriteria | Criteria for selecting videos.  | Yes ||

|| `FieldNames` | array of AdVideosFieldEnum | Names of video parameters to get.  | Yes ||

|| **AdVideosSelectionCriteria structure** | > | > | > ||

|| `Ids` | array of string | Select videos with the specified IDs. From 1 to 10 items in the array.  | Yes ||
|# 

## Response

Response structure in JSON format.

```javascript
{
   "method": "GetResponse",
   "result" : { /* required */
        "LimitedBy" : (long),
        "AdVideos" : [{
            "Id" : (string),
            "Status" : ("READY"|"ERROR"|"CONVERTING"|"NEW")
        }, ... ]
    }
}
```

#|
|| **Parameter**  | **Type**  | **Description**  ||

|| **result structure (for JSON) / GetResponse (for SOAP)** | > | > ||

|| `LimitedBy` | long | Sequential number of the last object returned. It is included if there was a limit on the number of objects in the response. See the section [Paginated data selection](https://yandex.com/dev/direct/doc/dg/best-practice/get.html).  ||

|| `AdVideos` | array of AdVideoGetItem | Video.  || 

|| **AdVideoGetItem structure** | > | > ||

|| `Id` | string | ID of the video.  ||

|| `Status` | StatusEnum | Video conversion status.  ||
|#