Retrieving List of Ad Sizes

Document created by pubmatic-archivist on Mar 27, 2017Last modified by catherine.racette on Jun 14, 2017
Version 4Show Document
  • View in full screen mode

Overview

This API allows you to retrieve the list of all the ad sizes present in the PubMatic system.

Request

         

URI
http://{domainName}/common/adSize?pageSize=20&pageNumber=1
HTTP Method
GET

Request Headers

                 

Header Name
Type
Value
Required
Description
Authorization
String
Bearer ${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 Query Parameters

                     

Parameter Name
Type
Required
Description
pageNumber
Integer
Optional
Page number to be fetched in case of multiple pages.
Its default value is 1.
pageSize
Integer
Optional
Maximum number of rows to be included in the response.
Its default value is 100.

Response

Response Headers

           

Response Header Name
Type
Content-type
application-json

Response Body

                                           

Response Body Parameter
Type
Description
metaData
Object
adSizeId
Integer
Unique identifier of the ad size.
name
String
Name of the ad size.
width
Integer
Width of the ad size.
height
Integer
Height of the ad size.
platforms.id
Integer
Unique identifier of the platform.
platforms.name
String
Name of the platform.

Sample Response JSON

 

{
    "metaData": {
        "startIndex": 4,
        "request": {
            "pageSize": 3,
            "pageNumber": 2
        },
        "totalRecords": 64,
        "endIndex": 6
    },
    "items": [
        {
            "adSizeId": 4,
            "name": "Small Rectangle",
            "width": 180,
            "height": 150,
            "platforms": [
                {
                    "id": 1,
                    "name": "Web"
                }
            ]
        },
        {
            "adSizeId": 5,
            "name": "Button",
            "width": 125,

            "height": 125,
            "platforms": [
                {
                    "id": 1,
                    "name": "Web"
                }
            ]
        },
        {
            "adSizeId": 6,
            "name": "Vertical Banner",
            "width": 120,
            "height": 240,
            "platforms": [
                {
                    "id": 1,
                    "name": "Web"
                }

            ]

        }

    ]

}

Attachments

    Outcomes