This endpoint returns all brands from Passport that your subscription has access to. Each brand is associated with a parent company. Results are paginated and can optionally be filtered by geography and category.

URI https://api.euromonitor.com/passport-catalog/brand
Supported verbs GET
Required headers Ocp-Apim-Subscription-Key, Accept, Authorization
Supported formats JSON, XML, CSV
Parameters
Format Optional Response format: json, csv, or xml. Defaults to json if not specified
PageNumber Optional Page number for pagination (starts at 1). Defaults to 1 if not specified
NoOfRecords Optional Number of records to return per page (max 10000). Defaults to 10000 if not specified
GeographyIds Optional A list of geography IDs to filter results by
CategoryIds Optional A list of category IDs to filter results by

A sample GET request might look like this:

GET https://api.euromonitor.com/passport-catalog/brand?PageNumber=1&NoOfRecords=100&GeographyIds=1,2&CategoryIds=101 HTTP/1.1
Host: api.euromonitor.com
Authorization: Bearer <tokenstring>
Accept: application/json; api-version=1.0
Ocp-Apim-Subscription-Key: 173bad6f0b319h23add9ad162493915e

A successful response body will have the following structure in JSON format:

[
    {
        "geographyId": 0,
        "geographyName": "string",
        "industryCode": "string",
        "industryName": "string",
        "categoryId": 0,
        "categoryName": "string",
        "companyId": 0,
        "companyName": "string",
        "brandId": 0,
        "brandName": "string"
    }
]

It is an array of Brand objects, each with the following members:

geographyId The geography ID associated with the brand record
geographyName The name of the geography associated with the brand record
industryCode The code for the industry this brand record is associated with
industryName The name of the industry this brand record is associated with
categoryId The category ID associated with the brand record
categoryName The name of the category associated with the brand record
companyId The unique identifier of the parent company that owns the brand
companyName The name of the parent company that owns the brand
brandId The unique identifier of the brand. Use a collection of these values when building requests to the main data services
brandName The name of the brand