CRcriteo
Campaign

/2026-01/marketing-solutions/marketplace-performance-outcomes/seller-campaigns/{sellerCampaignId}/budgets

Return a collection of budgets for this seller campaign filtered by optional filter parameters. If all parameters are omitted the entire collection to which the user has access is returned, except those whose endDate is in the past. Returned budgets must satisfy all supplied filter criteria if multiple parameters are used.

See the budgets endpoint for additional details.

get/2026-01/marketing-solutions/marketplace-performance-outcomes/seller-campaigns/{sellerCampaignId}/budgets

Request

  • Base URL
    https://api.criteo.com
  • Auth
    OAuth 2
    Authorization codehttps://api.criteo.com/oauth2
    Client credentials
    Token URLhttps://api.criteo.com/oauth2/token
    ScopesMarketingSolutions_Campaign_Read

Path parameters

sellerCampaignIdstring required

Return only budgets belonging to the given seller campaign. Format: {sellerId}.{campaignId}, e.g. 2578464.187625.

Query parameters

endAfterDatestring date-time

Return budgets that end after the given date using the yyyy-MM-DD format. If param is not provided, default behavior is to only return budgets that have not yet ended.

startBeforeDatestring date-time

Return budgets that start on or before the given date using the yyyy-MM-DD format.

status'Archived' | 'Current' | 'Scheduled'

Return only budgets with the given status.

typestring

Return only budgets with the given budget type.

withBalanceboolean

Return only budgets with a positive balance.

withSpendboolean

Return budgets with a positive spend.

Response

Success

amountnumber double nullable

Budget amount in the advertiser's currency

budgetTypestring

Type of budget: 'Daily' (daily cap), 'Capped' (lifetime with fixed amount), or 'Uncapped' (lifetime with no limit)

campaignIdsinteger[]

List of campaign IDs this budget applies to

endDatestring

End date of the budget period (format: YYYY-MM-DD), or empty string if open-ended

idstring

Unique budget identifier

isSuspendedboolean

Whether the budget has been manually suspended by the partner

sellerIdstring

Identifier of the seller this budget belongs to

spendnumber double nullable

Amount spent against this budget so far, or null if not available

startDatestring date

Start date of the budget period (format: YYYY-MM-DD)

status'Archived' | 'Current' | 'Scheduled'

Status of a seller budget

Example response

[
  {
    "id": "16501666",
    "sellerId": "10656107",
    "campaignIds": [
      436017
    ],
    "budgetType": "Capped",
    "amount": 462.47,
    "endDate": "2026-04-30",
    "spend": 117.59,
    "status": "Current",
    "isSuspended": false
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.