Retrieving List of Device Models for a Selected Make

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

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"
 }
]




Attachments

    Outcomes