> ## 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 Existing Campaigns

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>;
};

## **Retrieving All Campaigns**

When no advertiser is specified, all campaigns in your portfolio will be returned.

Additional filters are available to further refine the campaigns returned.

For example, to retrieve currently running campaigns in your portfolio, filter by `campaignStatus`:  

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

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

The API will return an array of campaigns that match the provided filters:

<CodeGroup>
  ```json JSON expandable theme={null}
  [
    {
      campaignType: 'LowerFunnel',
      advertiserName: 'Advertiser US',
      categories: [],
      budgetId: 99999,
      campaignId: 1234,
      campaignName: 'Web Conversion - Retargeting',
      advertiserId: 1,
      campaignStatus: 'Running',
      campaignBid: { 
        bidValue: 1.00,
        bidCurrency: 'USD',
        bidType: 'CPC'
      } 
    },
    {
      campaignType: 'MidFunnel',
      advertiserName: 'Advertiser US',
      categories: [],
      budgetId: 99998,
      campaignId: 5678,
      campaignName: 'Web Consideration - Similar Audience',
      advertiserId: 1,
      campaignStatus: 'Running',
      campaignBid: { 
        bidValue: 0.70,
        bidCurrency: 'USD',
        bidType: 'CPC'
      } 
    }
  ]
  ```
</CodeGroup>

A full list of all available filters is available on the [Campaigns API Technical Reference](/marketing-solutions/v2020.07/reference/campaignsgetcampaigns) page.      

## **Retrieving Campaigns for A Specific Advertiser**

By specifying one or many `advertiserIds`, you can request campaigns for a specific set of Criteo advertisers.

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

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.criteo.com/legacy/marketing/v1/campaigns?advertiserIds=1234%2C5678&campaignStatus=Running' \
    --header 'Accept: application/json'
  ```
</CodeGroup>

 

## **Retrieving Specific Campaigns**

You can also request the campaign details for a specific set of campaigns, provided they are owned by advertisers in your portfolio.

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

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.criteo.com/legacy/marketing/v1/campaigns?campaignIds=1234%2C5678' \
    --header 'Accept: application/json'
  ```
</CodeGroup>

 

## **Retrieving One Specific Campaign**

Alternatively, you can also request the details for one specific campaign by using a URL parameter, rather than a query parameter.

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

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

***

**What’s Next**

Update Bid Levels for Campaigns

* [Update Campaign Bids](/marketing-solutions/v2020.07/docs/update-campaign-bids)