> ## Documentation Index
> Fetch the complete documentation index at: https://developers.criteo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# [Campaigns] Get Campaign Categories

export const EndpointBadge = ({method = "GET", children}) => {
  const METHOD_STYLES = {
    GET: {
      bg: "mint-bg-[#2AB673]"
    },
    POST: {
      bg: "mint-bg-[#3064E3]"
    },
    PUT: {
      bg: "mint-bg-[#C28C30]"
    },
    PATCH: {
      bg: "mint-bg-[#DA622B]"
    },
    DELETE: {
      bg: "mint-bg-[#CB3A32]"
    },
    API: {
      bg: "mint-bg-black"
    }
  };
  const key = method.toUpperCase();
  const styles = METHOD_STYLES[key] ?? METHOD_STYLES.API;
  return <div className="relative mt-7">
      <span className={`absolute -top-2 -left-2 z-10 ${styles.bg} text-white px-2.5 py-0.5 rounded-full text-xs font-bold tracking-wide`}>
        {key}
      </span>
      {children}
    </div>;
};

## **Retrieve Categories Across All Campaigns**

<EndpointBadge method="get">
  ```http theme={null}
  https://api.criteo.com/legacy/marketing/v1/categories
  ```
</EndpointBadge>

You might want to retrieve a particular category's bid levels for all the campaigns with which it is associated:

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.criteo.com/legacy/marketing/v1/categories?categoryHashCodes=9876543' \
    --header 'Accept: application/json'
  ```
</CodeGroup>

The API will return an array of instances of this category. The `categoryHashCode` will be the same in all instances. The `campaignId` and the `categoryBid` will differ:

<CodeGroup>
  ```json JSON theme={null}
  [
    {
      categoryHashCode: 9876543,
      categoryName: 'cat-one',
      catalogId: 76543,
      catalogName: 'full-inventory',
      advertiserId: 1,
      advertiserName: 'Advertiser US',
      campaignId: 1234,
      campaignName: 'Web Conversion - Retargeting',
      averagePrice: 250.22,
      numberOfProducts: 151,
      categoryBid: { bidValue: 1.1, bidCurrency: 'USD', bidType: 'CPC' },
      enabled: true
    },
    {
      categoryHashCode: 9876543,
      categoryName: 'cat-one',
      catalogId: 76543,
      catalogName: 'full-inventory',
      advertiserId: 1,
      advertiserName: 'Advertiser US',
      campaignId: 5678,
      campaignName: 'Web Consideration - Similar Audience',
      averagePrice: 250.22,
      numberOfProducts: 151,
      categoryBid: { bidValue: 0.7, bidCurrency: 'USD', bidType: 'CPC' },
      enabled: true
    }
   ]
  ```
</CodeGroup>