Sign in

v1

latestOpenAPI 3.0.12026-07-22204678550.0 KB
Campaign

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

Modify an existing active budget to change its limitations or status. All three types of budgets can be modified.

See the additional restrictions listed in the PATCH budgets endpoint.

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

Path parameters

budgetIdstring int64 required

Id of the budget

Request body

amountstring
campaignIdsinteger[]
endDatestring
isSuspendedboolean
startDatestring date-time

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
}