/2026-01/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}

curl --request PATCH \ --url https://api.criteo.com/2026-01/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId} \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "amount": "<string>", "campaignIds": [ 123 ], "endDate": "<string>", "isSuspended": true, "startDate": "2023-11-07T05:31:56Z" } '

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

Authorizations

Authorization

string

header

required

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

Path Parameters

budgetId

string<int64>

required

Id of the budget

Body

application/json

Base data used to update a seller's budget

amount

string

campaignIds

integer<int32>[]

endDate

string

isSuspended

boolean

startDate

string<date-time>

Response

200 - application/json

Success

A budget defines spending constraints for a seller across one or more campaigns. Each seller can have one active budget per time period.

amount

number<double> | null

Budget amount in the advertiser's currency

budgetType

string

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

campaignIds

integer<int32>[]

List of campaign IDs this budget applies to

endDate

string

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

string

Unique budget identifier

isSuspended

boolean

Whether the budget has been manually suspended by the partner

sellerId

string

Identifier of the seller this budget belongs to

spend

number<double> | null

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

startDate

string<date>

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

status

enum<string>

Status of a seller budget

Available options:

Archived,

Current,

Scheduled