/2026-01/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
/2026-01/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}
Authorizations
Scopes
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.