/2026-01/retail-media/campaigns/{campaignId}/auction-line-items - Criteo Docs

Documentation Index

Fetch the complete documentation index at: /llms.txt

Use this file to discover all available pages before exploring further.

Endpoint

/2026-01/retail-media/campaigns/{campaignId}/auction-line-items

cURL

curl --request GET \
  --url https://api.criteo.com/2026-01/retail-media/campaigns/{campaignId}/auction-line-items \
  --header 'Authorization: Bearer <token>'

Python

import requests

url = "https://api.criteo.com/2026-01/retail-media/campaigns/{campaignId}/auction-line-items"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

JavaScript (Fetch)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.criteo.com/2026-01/retail-media/campaigns/{campaignId}/auction-line-items', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.criteo.com/2026-01/retail-media/campaigns/{campaignId}/auction-line-items",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
?>

Go

package main

import (
    "fmt"
    "net/http"
    "io"
)

func main() {

url := "https://api.criteo.com/2026-01/retail-media/campaigns/{campaignId}/auction-line-items"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("Authorization", "Bearer <token>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
    body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))
}

Unirest

HttpResponse<String> response = Unirest.get("https://api.criteo.com/2026-01/retail-media/campaigns/{campaignId}/auction-line-items")
  .header("Authorization", "Bearer <token>")
  .asString();

Ruby

require 'uri'
require 'net/http'

url = URI("https://api.criteo.com/2026-01/retail-media/campaigns/{campaignId}/auction-line-items")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

Response Format

200

{
  "data": [
    {
      "attributes": {
        "budgetRemaining": 123,
        "campaignId": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "name": "<string>",
        "startDate": "2023-11-07T05:31:56Z",
        "targetRetailerId": "<string>",
        "updatedAt": "2023-11-07T05:31:56Z",
        "budget": 123,
        "budgetSpent": 123,
        "dailyPacing": 123,
        "endDate": "2023-11-07T05:31:56Z",
        "flightSchedule": {
          "legs": [
            {
              "endTime": "<string>",
              "startTime": "<string>"
            }
          ]
        },
        "isAutoDailyPacing": true,
        "maxBid": 123,
        "monthlyPacing": 123,
        "targetBid": 123
      },
      "id": "<string>",
      "type": "<string>"
    }
  ],
  "errors": [
    {
      "code": "<string>",
      "detail": "<string>",
      "instance": "<string>",
      "source": {},
      "stackTrace": "<string>",
      "title": "<string>",
      "traceId": "<string>"
    }
  ],
  "metadata": {
    "limit": 123,
    "offset": 123,
    "count": 123
  },
  "warnings": [
    {
      "code": "<string>",
      "detail": "<string>",
      "instance": "<string>",
      "source": {},
      "stackTrace": "<string>",
      "title": "<string>",
      "traceId": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

campaignId

string

required

The id of the campaign

Query Parameters

limit

integer

default:25

The number of elements to be returned on a page.

Required range: 1 <= x <= 500

limitToIds

string[]

The ids to limit the auction line item results to

offset

integer

default:0

The (zero-based) starting offset into the collection.

Required range: 0 <= x <= 2147483647

Response

200 - application/json

Success

A top-level object that encapsulates a Criteo API response for several entities and metadata.