/2025-10/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}

curl --request GET \
  --url https://api.criteo.com/2025-10/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId} \
  --header 'Authorization: Bearer <token>'

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

/2025-10/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}

Return a budget. For example, { "id": "1759183", "sellerId": "321392", "campaignIds": [ 143962 ], "budgetType": "Capped", "amount": 1000, "startDate": "2021-01-11", "endDate": "2021-01-12", "spend": null, "status": "Active" } A budget limits the spend of a seller for one or more campaigns. There are three types of budget:<br /><b>Uncapped</b> budgets put no limit on the total amount of spend.<br /><b>Capped</b> budgets limit the total spend to a fixed amount.<br /><b>Daily</b> budgets limit daily spend to a fixed amount.<br /> In addition, budgets can limit the spend to a specific range of dates using the start and end date attributes. Finally a budget must be active to be used. <b>Spend</b> approximates the current spend against this budget. There may be a lag between when an ad is clicked and the time it accrues to the spend. Daily budgets show spend against the most recent day only.

GET

/

2025-10

/

marketing-solutions

/

marketplace-performance-outcomes

/

budgets

/

{budgetId}

/2025-10/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}

curl --request GET \
  --url https://api.criteo.com/2025-10/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId} \
  --header 'Authorization: Bearer <token>'

{
  "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.

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

id

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

/2025-10/marketing-solutions/marketplace-performance-outcomes/budgets

/2025-10/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}

⌘I