> ## 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/seller-campaigns/{sellerCampaignId}/budgets

> Return a collection of budgets for this seller campaign filtered by optional filter parameters.
If all parameters are omitted the entire collection to which the user has
access is returned, except those whose endDate is in the past. Returned budgets must satisfy all supplied filter
criteria if multiple parameters are used.
            
See the budgets endpoint for additional details.



## OpenAPI

````yaml https://api.criteo.com/2025-10/marketingsolutions/open-api-specifications.json get /2025-10/marketing-solutions/marketplace-performance-outcomes/seller-campaigns/{sellerCampaignId}/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/seller-campaigns/{sellerCampaignId}/budgets:
    get:
      tags:
        - Campaign
      summary: >-
        /2025-10/marketing-solutions/marketplace-performance-outcomes/seller-campaigns/{sellerCampaignId}/budgets
      description: "Return a collection of budgets for this seller campaign filtered by optional filter parameters.\r\nIf all parameters are omitted the entire collection to which the user has\r\naccess is returned, except those whose endDate is in the past. Returned budgets must satisfy all supplied filter\r\ncriteria if multiple parameters are used.\r\n            \r\nSee the budgets endpoint for additional details."
      operationId: GetMarketplaceBudgetsBySellerCampaign
      parameters:
        - 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: sellerCampaignId
          in: path
          description: >-
            Return only budgets belonging to the given seller campaign. Format:
            `{sellerId}.{campaignId}`, e.g. `2578464.187625`.
          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 a positive balance.
          schema:
            type: boolean
        - name: withSpend
          in: query
          description: Return budgets with a 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: {}

````