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

# /2025-10/marketing-solutions/marketplace-performance-outcomes/sellers/{sellerId}/budgets

> Return current (non-archived) budgets for this seller. Budgets whose endDate is in the past are excluded by default. To retrieve archived or past budgets, use the `/budgets` endpoint (GetMarketplaceSellerBudgets) with the `endAfterDate` filter instead.



## OpenAPI

````yaml https://api.criteo.com/2025-10/marketingsolutions/open-api-specifications.json get /2025-10/marketing-solutions/marketplace-performance-outcomes/sellers/{sellerId}/budgets
openapi: 3.0.1
info:
  title: Criteo API
  description: Criteo API - MarketingSolutions
  version: 2025-10
servers:
  - url: https://api.criteo.com
security:
  - oauth: []
tags:
  - name: Advertiser
  - name: Analytics
  - name: Audience
  - name: Campaign
  - name: Creative
  - name: Gateway
  - name: Reco
paths:
  /2025-10/marketing-solutions/marketplace-performance-outcomes/sellers/{sellerId}/budgets:
    get:
      tags:
        - Campaign
      summary: >-
        /2025-10/marketing-solutions/marketplace-performance-outcomes/sellers/{sellerId}/budgets
      description: >-
        Return current (non-archived) budgets for this seller. Budgets whose
        endDate is in the past are excluded by default. To retrieve archived or
        past budgets, use the `/budgets` endpoint (GetMarketplaceSellerBudgets)
        with the `endAfterDate` filter instead.
      operationId: GetMarketplaceBudgetsBySeller
      parameters:
        - name: campaignId
          in: query
          description: Return only budgets that pay for a given campaign.
          schema:
            type: integer
            format: int32
        - name: endAfterDate
          in: query
          description: "Return budgets that end after the given date using the `yyyy-MM-DD` format.\r\n            If param is not provided, default behavior is to only return budgets that have not yet ended."
          schema:
            type: string
            format: date-time
        - name: sellerId
          in: path
          description: Return only budgets belonging to the given seller.
          required: true
          schema:
            type: string
        - name: startBeforeDate
          in: query
          description: >-
            Return budgets that start on or before the given date using the
            `yyyy-MM-DD` format.
          schema:
            type: string
            format: date-time
        - name: status
          in: query
          description: Return only budgets with the given status.
          schema:
            enum:
              - Archived
              - Current
              - Scheduled
            type: string
        - name: type
          in: query
          description: Return only budgets with the given budget type.
          schema:
            type: string
        - name: withBalance
          in: query
          description: Return only budgets with the given status.
          schema:
            type: boolean
        - name: withSpend
          in: query
          description: Return budgets with any positive spend.
          schema:
            type: boolean
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $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: {}

````