Retrieving Details of an Ad Size

Before using PubMatic APIs, first generate the API Token. For more information, refer to  Getting Started with PubMatic APIs


This API allows you to retrieve the details of a specific ad size from the PubMatic system.




Request Headers


Header NameTypeValueRequiredDescription
AuthorizationStringBearer ${access_token}Yes

Publisher Token to authenticate and authorize the user calling the Unified Ad Server API. Send the access token generated for authentication at the place of ${access_token} in the request.

For more information about access tokens, refer to Getting Started with PubMatic APIs.

Request Path Parameters


Parameter NameTypeRequiredDescription
idintegeryesID of the ad size.


Response Headers


Response Header NameType
Content-type application-json

Response Body


Response Body ParameterTypeDescription
adSizeIdIntegerUnique identifier of the ad size.
nameStringName of the ad size.
widthIntegerWidth of the ad size.
heightIntegerHeight of the ad size.
platforms.idIntegerUnique identifier of the platform.
platforms.nameStringName of the platform.

Sample Response JSON

    "adSizeId": 78,
    "name": "Mobile - 800x1280",
    "width": 800,
    "height": 1280,
    "platforms": [
            "id": 2,
            "name": "Mobile Web"
            "id": 4,
            "name": "Mobile App IOS"
            "id": 5,
            "name": "Mobile App Android"

Error Codes

Error codes specific to this API method.


Error CodeError Description
CC03_004Resource not found

⇧ Top

Do you have feedback on this document? Let us know: email us.

Table of Contents