Page tree


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

Overview

This API allows you to retrieve the list of models for a given make.

Request

         

URI

http://{domainName}/common/mobileDevice?filters=deviceLevel+EQ+2&filters=make+EQ+ Apple &sort=deviceValue,make&useAllDimensions=true

HTTP MethodGET

Request Headers

                 

Header NameTypeValueRequiredDescription
AuthorizationStringBearer ${access_token}YesNeed to send the access token generating for authentication at the place of ${access_token}.
For more information about access tokens, refer to Getting Started with PubMatic APIs.


Response

Response Body

                                           

Parameter NameTypeDescription
idIntegerUnique identifier of the device manufacturer/make
nameStringName of the manufacturer/make or model
deviceValueStringDevice value of the manufacturer/make or model
makeStringName of the manufacturer/make
modelStringName of the model
deviceTypeIdIntegerUnique identifier for the device types. Refer to Device Type API for more detail.
deviceLevelInteger

Identifier for make/model. 

1=Manufacturer/Make

2=Model

Sample Response JSON

    

{

            "metaData": {

                        "startIndex": 1,

                        "totalRecords": 27,

                        "endIndex": 27

            },

            "items": [{

                        "id": 104,

                        "deviceValue": "Apple iPad",

                        "make": "Apple",

                        "model": "iPad",

                        "deviceTypeId": 4,

                        "deviceLevel": 2,

                        "name": "Apple iPad"

            }, {

                        "id": 105,

                        "deviceValue": "Apple iPAD 1",

                        "make": "Apple",

                        "model": "iPAD 1",

                        "deviceTypeId": 4,

                        "deviceLevel": 2,

                        "name": "Apple iPAD 1"

            }, {

                        "id": 106,

                        "deviceValue": "Apple iPAD 2",

                        "make": "Apple",

                        "model": "iPAD 2",

                        "deviceTypeId": 4,

                        "deviceLevel": 2,

                        "name": "Apple iPAD 2"

            }, {

                        "id": 107,

                        "deviceValue": "Apple iPAD 3",

                        "make": "Apple",

                        "model": "iPAD 3",

                        "deviceTypeId": 4,

                        "deviceLevel": 2,

                        "name": "Apple iPAD 3"

            }, {

                        "id": 3647,

                        "deviceValue": "Apple iPad 4",

                        "make": "Apple",

                        "model": "iPad 4",

                        "deviceTypeId": 4,

                        "deviceLevel": 2,

                        "name": "Apple iPad 4"

            }, {

                        "id": 609,

                        "deviceValue": "Apple iPad Air ",

                        "make": "Apple",

                        "model": "iPad Air",

                        "deviceTypeId": 4,

                        "deviceLevel": 2,

                        "name": "Apple iPad Air "

            }]

}‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Error Codes

Error codes specific to this API method.

[
 {
   "errorCode": "CC03_0004",
   "error": "Resource not found"
 }
]