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

# /2027-01/marketing-solutions/marketplace-performance-outcomes/stats/seller-delivery-report

> Search seller delivery aggregated by the requested dimensions and metrics.
<br />
Returns a columnar seller delivery report for an advertiser over the requested date interval, aggregated by the selected dimensions and metrics.
<br />
This endpoint is subject to specific rate limits.



## OpenAPI

````yaml https://api.criteo.com/2027-01/marketingsolutions/open-api-specifications.json post /2027-01/marketing-solutions/marketplace-performance-outcomes/stats/seller-delivery-report
openapi: 3.0.1
info:
  title: Criteo API
  description: Criteo API - MarketingSolutions
  version: 2027-01
servers:
  - url: https://api.criteo.com
security:
  - oauth: []
tags:
  - name: Advertiser
  - name: Analytics
  - name: Audience
  - name: Campaign
  - name: Catalog
  - name: Creative
  - name: Gateway
  - name: Reco
paths:
  /2027-01/marketing-solutions/marketplace-performance-outcomes/stats/seller-delivery-report:
    post:
      tags:
        - Analytics
      summary: >-
        /2027-01/marketing-solutions/marketplace-performance-outcomes/stats/seller-delivery-report
      description: >-
        Search seller delivery aggregated by the requested dimensions and
        metrics.

        <br />

        Returns a columnar seller delivery report for an advertiser over the
        requested date interval, aggregated by the selected dimensions and
        metrics.

        <br />

        This endpoint is subject to specific rate limits.
      operationId: CreateSellerDeliveryReport
      requestBody:
        description: Report criteria, including an inclusive date interval.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchSellerDeliveryReportRequest'
        required: true
        x-bodyName: request
      responses:
        '200':
          description: The report, including column metadata when no rows match.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SellerDeliveryReportListResponse'
      security:
        - oauth:
            - MarketingSolutions_Analytics_Read
components:
  schemas:
    SearchSellerDeliveryReportRequest:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/SellerDeliveryReportSearchResource'
      description: "Request body of a seller delivery report search.\r\nIts JSON shape is {data.type = SellerDeliveryReportSearch} and {data.attributes} = the search criteria."
    SellerDeliveryReportListResponse:
      type: object
      properties:
        data:
          type: array
          items:
            type: array
            items: {}
          description: "One positional value array per aggregated row, following the order of meta.columns.\r\nEmpty when no delivery matches."
        errors:
          type: array
          items:
            $ref: '#/components/schemas/CommonProblem'
          description: Errors that occured during this call.
          readOnly: true
        meta:
          $ref: '#/components/schemas/SellerDeliveryReportMeta'
        type:
          type: string
          readOnly: true
        warnings:
          type: array
          items:
            $ref: '#/components/schemas/CommonProblem'
          description: Warnings that occured during this call.
          readOnly: true
      description: Response of a seller delivery report search, in columnar format.
      x-readonly-type: true
      x-readonly-warnings: true
      x-readonly-errors: true
    SellerDeliveryReportSearchResource:
      type: object
      properties:
        attributes:
          $ref: '#/components/schemas/SellerDeliveryReportSearch'
        type:
          type: string
          description: The Type of the resource.
      description: >-
        A resource containing the seller delivery report search type and
        criteria.
    CommonProblem:
      type: object
      properties:
        code:
          type: string
          description: A machine-readable error code, expressed as a string value.
          nullable: true
        detail:
          type: string
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem
          nullable: true
        instance:
          type: string
          description: A URI that identifies the specific occurrence of the problem.
          nullable: true
        source:
          type: object
          additionalProperties:
            type: string
          description: >-
            A machine-readable structure to reference to the exact location(s)
            causing the error(s)
          nullable: true
        stackTrace:
          type: string
          nullable: true
        title:
          type: string
          description: A short human-readable description of the problem type
          nullable: true
        traceId:
          type: string
          description: The request correlation ID this problem comes from.
          nullable: true
        traceIdentifier:
          type: string
          description: >-
            The request correlation ID this problem comes from. (deprecated, use
            traceId instead)
          nullable: true
        type:
          enum:
            - unknown
            - access-control
            - authentication
            - authorization
            - availability
            - deprecation
            - quota
            - validation
          type: string
          description: The problem's category.
          nullable: true
      description: Common problem object.
    SellerDeliveryReportMeta:
      type: object
      properties:
        advertiserId:
          type: string
          description: Advertiser for which the report was generated.
        columns:
          type: array
          items:
            $ref: '#/components/schemas/SellerDeliveryReportColumn'
          description: "Ordered column names: requested entity dimensions in request order, then periodStartDay,\r\nthen requested metrics in request order. Present even when data is empty."
        currency:
          type: string
          description: ISO 4217 currency code applying to all delivery metrics.
        lastConsolidatedDay:
          type: string
          description: >-
            Latest advertiser-local day considered consolidated, in yyyy-MM-dd
            format. Null if none found.
          nullable: true
        rows:
          type: integer
          description: Number of rows in data.
          format: int32
        timezoneId:
          type: string
          description: >-
            IANA timezone ID of the advertiser (e.g. Europe/Paris), used to
            interpret and group dates.
      description: Context shared by every row of a seller delivery report.
    SellerDeliveryReportSearch:
      required:
        - advertiserId
        - dimensions
        - endDay
        - metrics
        - startDay
      type: object
      properties:
        adSetIds:
          type: array
          items:
            type: string
          description: >-
            Optional ad set filter. If omitted or empty, all ad sets are
            included.
        advertiserId:
          type: string
          description: Advertiser for which the report is generated.
        budgetIds:
          type: array
          items:
            type: string
          description: "Optional budget filter. \"NULL\" selects delivery not assigned to any seller budget.\r\nIf omitted or empty, all budgets and unassigned delivery are included."
        dimensions:
          type: array
          items:
            $ref: '#/components/schemas/SellerDeliveryDimension'
          description: "Entity dimensions used for aggregation, plus at most one optional time dimension.\r\nThe {sellerId} dimension is required. Without a time dimension, delivery is aggregated over the\r\ncomplete requested startDay-endDay interval."
        endDay:
          type: string
          description: Last local date included in the report, in yyyy-MM-dd format.
          format: date
        metrics:
          type: array
          items:
            $ref: '#/components/schemas/SellerDeliveryMetric'
          description: >-
            Metrics included in each result row. At least one metric is
            required.
        onlyOverdelivering:
          type: boolean
          description: >-
            When true, excludes aggregated rows whose overdelivery is zero.
            Defaults to false.
          default: false
        sellerIds:
          type: array
          items:
            type: string
          description: >-
            Optional seller filter. If omitted or empty, all sellers are
            included.
        startDay:
          type: string
          description: First local date included in the report, in yyyy-MM-dd format.
          format: date
      description: >-
        Criteria used to generate a seller delivery report for a multi-seller
        campaign advertiser.
    SellerDeliveryReportColumn:
      enum:
        - sellerId
        - adSetId
        - budgetId
        - periodStartDay
        - grossDelivery
        - overDelivery
        - netDelivery
      type: string
      description: Columns labeling the values of each row of a seller delivery report.
      format: string
      x-ms-enum:
        name: SellerDeliveryReportColumn
        modelAsString: false
        values:
          - 0
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
    SellerDeliveryDimension:
      enum:
        - sellerId
        - adSetId
        - budgetId
        - day
        - week
        - month
      type: string
      description: Dimensions supported by a seller delivery report.
      format: string
      x-ms-enum:
        name: SellerDeliveryDimension
        modelAsString: false
        values:
          - 0
          - 1
          - 2
          - 3
          - 4
          - 5
    SellerDeliveryMetric:
      enum:
        - grossDelivery
        - overDelivery
        - netDelivery
      type: string
      description: >-
        Metrics supported by a seller delivery report. All metrics are in the
        advertiser currency.
      format: string
      x-ms-enum:
        name: SellerDeliveryMetric
        modelAsString: false
        values:
          - 0
          - 1
          - 2
  securitySchemes:
    oauth:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://api.criteo.com/oauth2/token
          scopes:
            MarketingSolutions_Analytics_Read: >-
              Grants Read access to the capabilities from the Analytics domain,
              for MarketingSolutions applications
            MarketingSolutions_Audience_Manage: >-
              Grants Manage access to the capabilities from the Audience domain,
              for MarketingSolutions applications
            MarketingSolutions_Audience_Read: >-
              Grants Read access to the capabilities from the Audience domain,
              for MarketingSolutions applications
            MarketingSolutions_Campaign_Manage: >-
              Grants Manage access to the capabilities from the Campaign domain,
              for MarketingSolutions applications
            MarketingSolutions_Campaign_Read: >-
              Grants Read access to the capabilities from the Campaign domain,
              for MarketingSolutions applications
            MarketingSolutions_Catalog_Manage: >-
              Grants Manage access to the capabilities from the Catalog domain,
              for MarketingSolutions applications
            MarketingSolutions_Catalog_Read: >-
              Grants Read access to the capabilities from the Catalog domain,
              for MarketingSolutions applications
            MarketingSolutions_Creative_Manage: >-
              Grants Manage access to the capabilities from the Creative domain,
              for MarketingSolutions applications
            MarketingSolutions_Creative_Read: >-
              Grants Read access to the capabilities from the Creative domain,
              for MarketingSolutions applications
            MarketingSolutions_Reco_Manage: >-
              Grants Manage access to the capabilities from the Reco domain, for
              MarketingSolutions applications
            MarketingSolutions_Reco_Read: >-
              Grants Read access to the capabilities from the Reco domain, for
              MarketingSolutions applications
        authorizationCode:
          authorizationUrl: https://api.criteo.com/oauth2
          tokenUrl: https://api.criteo.com/oauth2/token
          scopes:
            MarketingSolutions_Analytics_Read: >-
              Grants Read access to the capabilities from the Analytics domain,
              for MarketingSolutions applications
            MarketingSolutions_Audience_Manage: >-
              Grants Manage access to the capabilities from the Audience domain,
              for MarketingSolutions applications
            MarketingSolutions_Audience_Read: >-
              Grants Read access to the capabilities from the Audience domain,
              for MarketingSolutions applications
            MarketingSolutions_Campaign_Manage: >-
              Grants Manage access to the capabilities from the Campaign domain,
              for MarketingSolutions applications
            MarketingSolutions_Campaign_Read: >-
              Grants Read access to the capabilities from the Campaign domain,
              for MarketingSolutions applications
            MarketingSolutions_Catalog_Manage: >-
              Grants Manage access to the capabilities from the Catalog domain,
              for MarketingSolutions applications
            MarketingSolutions_Catalog_Read: >-
              Grants Read access to the capabilities from the Catalog domain,
              for MarketingSolutions applications
            MarketingSolutions_Creative_Manage: >-
              Grants Manage access to the capabilities from the Creative domain,
              for MarketingSolutions applications
            MarketingSolutions_Creative_Read: >-
              Grants Read access to the capabilities from the Creative domain,
              for MarketingSolutions applications
            MarketingSolutions_Reco_Manage: >-
              Grants Manage access to the capabilities from the Reco domain, for
              MarketingSolutions applications
            MarketingSolutions_Reco_Read: >-
              Grants Read access to the capabilities from the Reco domain, for
              MarketingSolutions applications

````