Discard
GuidesAPI ReferenceChangelogDiscussions
GuidesAPI ReferenceChangelogDiscussionsLog In

An account represents a brand, agency, marketplace seller, or retailer; it is a business & billing entity that contains campaigns. Accounts are created by Criteo, please reach out to your account representative

Endpoint

GET /accounts Get All Accounts

Account Attributes

Attribute

Description

Values

id string

Account ID

int64

name string

Account name

510 char limit

type enum

Account type

demand, supply

subtype enum

Account subtype

brand, seller

countries string array

Countries associated with the account

ISO-3166 alpha-2 (eg. US, FR)

currency string

One single currency for billing, budgeting, bid settings & campaign performance metrics

ISO-4217 (eg. USD, EUR)

parentAccountLabel string

Label used to associate multiple accounts; defaults to the account name

510 char limit

timeZone string

Account time zone

database tz syntax, eg. America/New_York, Europe/Paris, UTC

Get All Accounts

This endpoint lists all accounts that your API credentials have access to. Response results will be provided in paginated form

https://api.criteo.com/2022-04/retail-media/accounts

Sample Request

curl -X GET "https://api.criteo.com/2022-04/retail-media/accounts" \
    -H "Authorization: Bearer myaccesstoken"

Sample Response

{
    "data": [
        {
            "type": "RetailMediaAccount",
            "id": "18446744073709551616",
            "attributes": {
                "name": "Account 123",
                "type": "demand",
                "subtype": "brand",
                "countries": ["US"],
                "currency": "USD",
                "parentAccountLabel": "Parent Company 123",
                "timeZone": "America/New_York"
            }
        },
 
        // ...
 
        {
            "type": "RetailMediaAccount",
            "id": "17087025952598080003",
            "attributes": {
                "name": "Account 789",
                "type": "demand",
                "subtype": "brand",
                "countries": ["FR",
                              "DE",
                              "GB"],
                "currency": "EUR",
                "parentAccountLabel": "Parent Company 123",
                "timeZone": "Europe/Paris"
            }
        }
    ],
    "metadata": {
        "totalItemsAcrossAllPages": 80,
        "currentPageSize": 25,
        "currentPageIndex": 1,
        "totalPages": 4,
        "nextPage": "https://api.criteo.com/2022-04/retail-media/accounts?pageIndex=2&pageSize=25",
        "previousPage": "https://api.criteo.com/2022-04/retail-media/accounts?pageIndex=0&pageSize=25"
    }
}

What’s Next
Did this page help you?