> ## Documentation Index
> Fetch the complete documentation index at: https://developers.criteo.com/llms.txt
> Use this file to discover all available pages before exploring further.

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



## OpenAPI

````yaml https://api.criteo.com/2026-01/marketingsolutions/open-api-specifications.json get /2026-01/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}
openapi: 3.0.1
info:
  title: Criteo API
  description: Criteo API - MarketingSolutions
  version: 2026-01
servers:
  - url: https://api.criteo.com
security:
  - oauth: []
tags:
  - name: Advertiser
  - name: Analytics
  - name: Audience
  - name: Campaign
  - name: Creative
  - name: Gateway
  - name: Reco
paths:
  /2026-01/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}:
    get:
      tags:
        - Campaign
      summary: >-
        /2026-01/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}
      description: "Return a budget. For example,\r\n            \r\n    {\r\n        \"id\": \"1759183\",\r\n        \"sellerId\": \"321392\",\r\n        \"campaignIds\": [\r\n            143962\r\n        ],\r\n        \"budgetType\": \"Capped\",\r\n        \"amount\": 1000,\r\n        \"startDate\": \"2021-01-11\",\r\n        \"endDate\": \"2021-01-12\",\r\n        \"spend\": null,\r\n        \"status\": \"Active\"\r\n    }\r\n            \r\nA budget limits the spend of a seller for one or more campaigns.\r\n            \r\nThere 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 />\r\n            \r\nIn addition, budgets can limit the spend to a specific range of dates using\r\nthe start and end date attributes. Finally a budget must be active to be used.\r\n            \r\n<b>Spend</b> approximates the current spend against this budget. There may be a lag\r\nbetween when an ad is clicked and the time it accrues to the spend. Daily budgets\r\nshow spend against the most recent day only."
      operationId: GetMarketplaceSellerBudget
      parameters:
        - name: budgetId
          in: path
          description: Id of the budget.
          required: true
          schema:
            type: string
            format: int64
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SellerBudgetMessage'
      security:
        - oauth:
            - MarketingSolutions_Campaign_Read
components:
  schemas:
    SellerBudgetMessage:
      type: object
      properties:
        amount:
          type: number
          description: Budget amount in the advertiser's currency
          format: double
          nullable: true
        budgetType:
          type: string
          description: >-
            Type of budget: 'Daily' (daily cap), 'Capped' (lifetime with fixed
            amount), or 'Uncapped' (lifetime with no limit)
        campaignIds:
          type: array
          items:
            type: integer
            format: int32
          description: List of campaign IDs this budget applies to
        endDate:
          type: string
          description: >-
            End date of the budget period (format: YYYY-MM-DD), or empty string
            if open-ended
        id:
          type: string
          description: Unique budget identifier
        isSuspended:
          type: boolean
          description: Whether the budget has been manually suspended by the partner
        sellerId:
          type: string
          description: Identifier of the seller this budget belongs to
        spend:
          type: number
          description: Amount spent against this budget so far, or null if not available
          format: double
          nullable: true
        startDate:
          type: string
          description: 'Start date of the budget period (format: YYYY-MM-DD)'
          format: date
        status:
          $ref: '#/components/schemas/SellerBudgetStatusV2'
      description: >-
        A budget defines spending constraints for a seller across one or more
        campaigns. Each seller can have one active budget per time period.
      example:
        id: '16501666'
        sellerId: '10656107'
        campaignIds:
          - 436017
        budgetType: Capped
        amount: 462.47
        endDate: '2026-04-30'
        spend: 117.59
        status: Current
        isSuspended: false
    SellerBudgetStatusV2:
      enum:
        - Archived
        - Current
        - Scheduled
      type: string
      description: Status of a seller budget
  securitySchemes:
    oauth:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://api.criteo.com/oauth2/token
          scopes: {}
        authorizationCode:
          authorizationUrl: https://api.criteo.com/oauth2
          tokenUrl: https://api.criteo.com/oauth2/token
          scopes: {}

````