---
title: "/2026-01/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}"
method: GET
path: "/2026-01/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}"
tags: ["Campaign"]
---

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

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

## Request

- Base URL: `https://api.criteo.com`
- URL: `https://api.criteo.com/2026-01/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}`
- Auth: OAuth 2
  - Authorization code: `https://api.criteo.com/oauth2`
  - Client credentials
  - Token URL: `https://api.criteo.com/oauth2/token` scopes: `MarketingSolutions_Campaign_Read`

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.

## Path parameters

- `budgetId` string, int64, required

## Response `200`

Success

- SellerBudgetMessage: 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, nullable: 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[]: 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, nullable: 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` 'Archived' | 'Current' | 'Scheduled': Status of a seller budget

---

[API](https://skmtc.dev/criteo/apis/criteo-api.md) - [All operations](https://skmtc.dev/criteo/apis/criteo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/criteo/apis/criteo-api/revisions/c1721589426a?raw)