Retrieving List of Device Models for a Selected Make

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 list of models for a given make.




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


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 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.

Identifier for make/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"

⇧ Top

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

Table of Contents