---
metadata:
  - name: generator
    content: Diplodoc Platform v5.46.1
alternate:
  - https://yandex.ru/dev/partner-statistics/doc/en/reference/mobile-adunit/getMobileAdUnit.md
  - https://yandex.ru/dev/partner-statistics/doc/ru/reference/mobile-adunit/getMobileAdUnit.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/partner-statistics/doc/en/llms.txt

<div class="openapi">

# Getting a mobile ad unit by ID

<!-- markdownlint-disable-file -->

{% list tabs %}

- Info

  ## Request
  
  <div class="openapi__requests">
  
  <div class="openapi__request__wrapper" style="--method: var(--dc-openapi-methods-get);margin-bottom: 12px">
  
  <div class="openapi__request">
  
  GET {.openapi__method}
  ```text translate=no
  https://partner.yandex.ru/api/mobile/adunit/{id}
  ```
  
  </div>
  
  Partner API
  
  </div>
  
  </div>
  
  ### Path parameters
  
  #|
  || **Name** | **Description** ||
  ||
  
  _id_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: string
  
  Mobile ad unit ID
  
  _Pattern:_{.json-schema-reset .json-schema-assertion} `R-M-\d{1,10}-\d{1,7}`
  
  _Example:_{.json-schema-reset .json-schema-example} ``
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  ## Responses
  
  <div class="openapi__response__code__200">
  
  ## 200 OK
  
  OK
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "data": {
      "applicationId": 0.5,
      "caption": "example",
      "createDate": "2025-01-01T00:00:00Z",
      "editable": true,
      "id": "example",
      "status": "UNKNOWN",
      "strategy": {},
      "type": "example"
    },
    "warnings": [
      "example"
    ]
  }
  ```
  
  {% endcut %}
  
  #|
  || **Name** | **Description** ||
  ||
  
  _data_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: [MobileAdUnit](#entity-MobileAdUnit)
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  {
    "applicationId": 0.5,
    "caption": "example",
    "createDate": "2025-01-01T00:00:00Z",
    "editable": true,
    "id": "example",
    "status": "UNKNOWN",
    "strategy": {},
    "type": "example"
  }
  ```
  
  {% endcut %}
  {.table-cell}
  ||
  ||
  
  _warnings_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string[]
  
  List of warnings that occurred when performing an action
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  [
    "example"
  ]
  ```
  
  {% endcut %}
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  </div>
  
  <div class="openapi-entity">
  
  ### AdUnitStatus {#entity-AdUnitStatus}
  
  **Type**: string
  
  _Enum:_{.json-schema-reset .json-schema-value} `UNKNOWN`, `ENABLED`, `ARCHIVED`
  
  </div>
  
  <div class="openapi-entity">
  
  ### Strategy {#entity-Strategy}
  
  Ad traffic management strategy
  
  #|
  || **Name** | **Description** ||
  ||
  
  _type_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: string
  
  Strategy type
  
  _Example:_{.json-schema-reset .json-schema-example} `example`
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  {
    "type": "example"
  }
  ```
  
  {% endcut %}
  
  </div>
  
  <div class="openapi-entity">
  
  ### MaxRevenueStrategy {#entity-MaxRevenueStrategy}
  
  Doesn't limit the impression cost
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: [Strategy](#entity-Strategy)
  
    Ad traffic management strategy
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "type": "example"
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  {
    "type": "example"
  }
  ```
  
  {% endcut %}
  
  </div>
  
  <div class="openapi-entity">
  
  ### MinCpmVStrategy {#entity-MinCpmVStrategy}
  
  The threshold (floor) sets the cost per one thousand viewable impressions
  
  **Type**: object
  
  {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: [Strategy](#entity-Strategy)
  
    Ad traffic management strategy
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "type": "example"
    }
    ```
  
    {% endcut %}
  
  - {% cut "**Type**: object" %}
  
    #|
    ||
  
    _mincpm_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: number
  
    Floor value
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "mincpm": 0.5
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  {
    "type": "example",
    "mincpm": 0.5
  }
  ```
  
  {% endcut %}
  
  </div>
  
  <div class="openapi-entity">
  
  ### MinECpmStrategy {#entity-MinECpmStrategy}
  
  The threshold (floor) sets the cost per one thousand impressions
  
  **Type**: object
  
  {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: [Strategy](#entity-Strategy)
  
    Ad traffic management strategy
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "type": "example"
    }
    ```
  
    {% endcut %}
  
  - {% cut "**Type**: object" %}
  
    #|
    ||
  
    _mincpm_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: number
  
    Floor value
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "mincpm": 0.5
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  {
    "type": "example",
    "mincpm": 0.5
  }
  ```
  
  {% endcut %}
  
  </div>
  
  <div class="openapi-entity">
  
  ### BaseMobileAdUnit {#entity-BaseMobileAdUnit}
  
  #|
  || **Name** | **Description** ||
  ||
  
  _applicationId_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: number
  
  App ID
  {.table-cell}
  ||
  ||
  
  _id_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: string
  
  Unit ID
  
  _Min length:_{.json-schema-reset .json-schema-assertion} `7`
  
  _Pattern:_{.json-schema-reset .json-schema-assertion} `R-M-\d{1,10}-\d{1,7}`
  
  _Example:_{.json-schema-reset .json-schema-example} `example`
  {.table-cell}
  ||
  ||
  
  _type_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: string
  
  Type of ad unit or unit action
  
  _Example:_{.json-schema-reset .json-schema-example} `example`
  {.table-cell}
  ||
  ||
  
  _caption_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string
  
  Description
  
  _Min length:_{.json-schema-reset .json-schema-assertion} `1`
  
  _Max length:_{.json-schema-reset .json-schema-assertion} `255`
  
  _Example:_{.json-schema-reset .json-schema-example} `example`
  {.table-cell}
  ||
  ||
  
  _createDate_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string&lt;date-time&gt;
  
  Unit creation date
  
  _Example:_{.json-schema-reset .json-schema-example} `2025-01-01T00:00:00Z`
  {.table-cell}
  ||
  ||
  
  _editable_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: boolean
  
  Editability
  {.table-cell}
  ||
  ||
  
  _status_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: [AdUnitStatus](#entity-AdUnitStatus)
  
  _Enum:_{.json-schema-reset .json-schema-value} `UNKNOWN`, `ENABLED`, `ARCHIVED`
  {.table-cell}
  ||
  ||
  
  _strategy_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  {% cut "**One of 3 types**" %}{.json-schema-combinators data-marker=or}
  
  - **Maximum revenue**
  
    **Type**: [MaxRevenueStrategy](#entity-MaxRevenueStrategy)
  
    Doesn't limit the impression cost
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "type": "example"
    }
    ```
  
    {% endcut %}
  
  - **Minimum CPMV floor**
  
    **Type**: [MinCpmVStrategy](#entity-MinCpmVStrategy)
  
    The threshold (floor) sets the cost per one thousand viewable impressions
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "type": "example",
      "mincpm": 0.5
    }
    ```
  
    {% endcut %}
  
  - **Minimum eCPM floor**
  
    **Type**: [MinECpmStrategy](#entity-MinECpmStrategy)
  
    The threshold (floor) sets the cost per one thousand impressions
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "type": "example",
      "mincpm": 0.5
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  Ad traffic management strategy, CPM floors
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  {
    "type": "example"
  }
  ```
  
  {% endcut %}
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  {
    "applicationId": 0.5,
    "caption": "example",
    "createDate": "2025-01-01T00:00:00Z",
    "editable": true,
    "id": "example",
    "status": "UNKNOWN",
    "strategy": {
      "type": "example"
    },
    "type": "example"
  }
  ```
  
  {% endcut %}
  
  </div>
  
  <div class="openapi-entity">
  
  ### AppOpenMobileAdUnit {#entity-AppOpenMobileAdUnit}
  
  {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: [BaseMobileAdUnit](#entity-BaseMobileAdUnit)
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "applicationId": 0.5,
      "caption": "example",
      "createDate": "2025-01-01T00:00:00Z",
      "editable": true,
      "id": "example",
      "status": "UNKNOWN",
      "strategy": {
        "type": "example"
      },
      "type": "example"
    }
    ```
  
    {% endcut %}
  
  - **App open ad unit**
  
    **Type**: object
  
    App open ad unit
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {}
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  {
    "applicationId": 0.5,
    "caption": "example",
    "createDate": "2025-01-01T00:00:00Z",
    "editable": true,
    "id": "example",
    "status": "UNKNOWN",
    "strategy": {
      "type": "example"
    },
    "type": "example"
  }
  ```
  
  {% endcut %}
  
  </div>
  
  <div class="openapi-entity">
  
  ### RewardedMobileAdUnit {#entity-RewardedMobileAdUnit}
  
  {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: [BaseMobileAdUnit](#entity-BaseMobileAdUnit)
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "applicationId": 0.5,
      "caption": "example",
      "createDate": "2025-01-01T00:00:00Z",
      "editable": true,
      "id": "example",
      "status": "UNKNOWN",
      "strategy": {
        "type": "example"
      },
      "type": "example"
    }
    ```
  
    {% endcut %}
  
  - {% cut "**Type**: Rewarded ad unit" %}
  
    #|
    ||
  
    _currencyType_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    In-app currency name
  
    _Min length:_{.json-schema-reset .json-schema-assertion} `1`
  
    _Max length:_{.json-schema-reset .json-schema-assertion} `64`
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    ||
  
    _currencyValue_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: number
  
    Reward amount for viewing the ad in the in-app currency
  
    _Min value:_{.json-schema-reset .json-schema-assertion} `0`
  
    _Max value:_{.json-schema-reset .json-schema-assertion} `100000000`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    Rewarded ad unit
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "currencyType": "example",
      "currencyValue": 0
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  {
    "applicationId": 0.5,
    "caption": "example",
    "createDate": "2025-01-01T00:00:00Z",
    "editable": true,
    "id": "example",
    "status": "UNKNOWN",
    "strategy": {
      "type": "example"
    },
    "type": "example",
    "currencyType": "example",
    "currencyValue": 0
  }
  ```
  
  {% endcut %}
  
  </div>
  
  <div class="openapi-entity">
  
  ### BannerMobileAdUnit {#entity-BannerMobileAdUnit}
  
  {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: [BaseMobileAdUnit](#entity-BaseMobileAdUnit)
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "applicationId": 0.5,
      "caption": "example",
      "createDate": "2025-01-01T00:00:00Z",
      "editable": true,
      "id": "example",
      "status": "UNKNOWN",
      "strategy": {
        "type": "example"
      },
      "type": "example"
    }
    ```
  
    {% endcut %}
  
  - **Banner**
  
    **Type**: object
  
    Banner
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {}
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  {
    "applicationId": 0.5,
    "caption": "example",
    "createDate": "2025-01-01T00:00:00Z",
    "editable": true,
    "id": "example",
    "status": "UNKNOWN",
    "strategy": {
      "type": "example"
    },
    "type": "example"
  }
  ```
  
  {% endcut %}
  
  </div>
  
  <div class="openapi-entity">
  
  ### NativeMobileAdUnit {#entity-NativeMobileAdUnit}
  
  {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: [BaseMobileAdUnit](#entity-BaseMobileAdUnit)
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "applicationId": 0.5,
      "caption": "example",
      "createDate": "2025-01-01T00:00:00Z",
      "editable": true,
      "id": "example",
      "status": "UNKNOWN",
      "strategy": {
        "type": "example"
      },
      "type": "example"
    }
    ```
  
    {% endcut %}
  
  - **Native ad unit**
  
    **Type**: object
  
    Native ad unit
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {}
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  {
    "applicationId": 0.5,
    "caption": "example",
    "createDate": "2025-01-01T00:00:00Z",
    "editable": true,
    "id": "example",
    "status": "UNKNOWN",
    "strategy": {
      "type": "example"
    },
    "type": "example"
  }
  ```
  
  {% endcut %}
  
  </div>
  
  <div class="openapi-entity">
  
  ### InterstitialMobileAdUnit {#entity-InterstitialMobileAdUnit}
  
  {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: [BaseMobileAdUnit](#entity-BaseMobileAdUnit)
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "applicationId": 0.5,
      "caption": "example",
      "createDate": "2025-01-01T00:00:00Z",
      "editable": true,
      "id": "example",
      "status": "UNKNOWN",
      "strategy": {
        "type": "example"
      },
      "type": "example"
    }
    ```
  
    {% endcut %}
  
  - **Interstitial ad unit**
  
    **Type**: object
  
    Interstitial ad unit
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {}
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  {
    "applicationId": 0.5,
    "caption": "example",
    "createDate": "2025-01-01T00:00:00Z",
    "editable": true,
    "id": "example",
    "status": "UNKNOWN",
    "strategy": {
      "type": "example"
    },
    "type": "example"
  }
  ```
  
  {% endcut %}
  
  </div>
  
  <div class="openapi-entity">
  
  ### MobileAdUnit {#entity-MobileAdUnit}
  
  {% cut "**One of 5 types**" %}{.json-schema-combinators data-marker=or}
  
  - **Type**: [AppOpenMobileAdUnit](#entity-AppOpenMobileAdUnit)
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "applicationId": 0.5,
      "caption": "example",
      "createDate": "2025-01-01T00:00:00Z",
      "editable": true,
      "id": "example",
      "status": "UNKNOWN",
      "strategy": {
        "type": "example"
      },
      "type": "example"
    }
    ```
  
    {% endcut %}
  
  - **Type**: [RewardedMobileAdUnit](#entity-RewardedMobileAdUnit)
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "applicationId": 0.5,
      "caption": "example",
      "createDate": "2025-01-01T00:00:00Z",
      "editable": true,
      "id": "example",
      "status": "UNKNOWN",
      "strategy": {
        "type": "example"
      },
      "type": "example",
      "currencyType": "example",
      "currencyValue": 0
    }
    ```
  
    {% endcut %}
  
  - **Type**: [BannerMobileAdUnit](#entity-BannerMobileAdUnit)
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "applicationId": 0.5,
      "caption": "example",
      "createDate": "2025-01-01T00:00:00Z",
      "editable": true,
      "id": "example",
      "status": "UNKNOWN",
      "strategy": {
        "type": "example"
      },
      "type": "example"
    }
    ```
  
    {% endcut %}
  
  - **Type**: [NativeMobileAdUnit](#entity-NativeMobileAdUnit)
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "applicationId": 0.5,
      "caption": "example",
      "createDate": "2025-01-01T00:00:00Z",
      "editable": true,
      "id": "example",
      "status": "UNKNOWN",
      "strategy": {
        "type": "example"
      },
      "type": "example"
    }
    ```
  
    {% endcut %}
  
  - **Type**: [InterstitialMobileAdUnit](#entity-InterstitialMobileAdUnit)
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "applicationId": 0.5,
      "caption": "example",
      "createDate": "2025-01-01T00:00:00Z",
      "editable": true,
      "id": "example",
      "status": "UNKNOWN",
      "strategy": {
        "type": "example"
      },
      "type": "example"
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  {
    "applicationId": 0.5,
    "caption": "example",
    "createDate": "2025-01-01T00:00:00Z",
    "editable": true,
    "id": "example",
    "status": "UNKNOWN",
    "strategy": {},
    "type": "example"
  }
  ```
  
  {% endcut %}
  
  </div>
  
  </div>
        

- Console

  ```openapi-sandbox translate=no
  pathParams:
    - name: id
      in: path
      description: Mobile ad unit ID
      required: true
      schema:
        pattern: R-M-\d{1,10}-\d{1,7}
        type: string
  searchParams: []
  headers: []
  body: null
  schema: {}
  method: get
  security:
    - type: oauth2
      flows:
        implicit:
          authorizationUrl: https://oauth.yandex.ru/authorize
          scopes:
            pi:access-ad-inventory-api: Yandex Advertising Network (Inventory Management API)
    - type: apiKey
      name: Authorization
      in: header
  path: mobile/adunit/{id}
  host: https://partner.yandex.ru
  
  ```
        

{% endlist %}


</div>

[*Deprecated]: No longer supported, please use an alternative and newer version.