/2026-01/marketing-solutions/marketplace-performance-outcomes/budgets
Return a collection of budgets filtered by optional filter parameters, including archived budgets. This is the endpoint to use when investigating past budget history.
By default, budgets whose endDate is in the past are excluded. Use endAfterDate to retrieve archived budgets (e.g. endAfterDate=2025-01-01 returns all budgets ending after that date). Use sellerId to filter to a specific seller — omitting it on large advertisers causes timeouts.
Date filter. To find budgets that were active on a specific date, set both startBeforeDate and endAfterDate to that day.
Spend. If endAfterDate is supplied, the spend excludes spend that happened after that date. For daily budgets, only the spend for the final day is displayed.
Authorizations
Scopes
Query Parameters
Response
Success