Sign in

v1

latestOpenAPI 3.0.12026-07-22204678550.0 KB
Campaign

/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.

<b>Date filter.</b> To find budgets that were active on a specific date, set both startBeforeDate and endAfterDate to that day.

<b>Spend.</b> 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.

get/2026-01/marketing-solutions/marketplace-performance-outcomes/budgets

Query parameters

advertiserIdinteger

Return only budgets belonging to the specified advertiser

campaignIdinteger

Return only budgets that pay for a given campaign.

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.

sellerIdstring

Return only budgets belonging to the given seller.

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 the given status.

withSpendboolean

Return budgets with any 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
  }
]