> ## 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-04/transactions/report

> This Transactions endpoint provides transactions id related data.
<br/><br/>
This endpoint supports data retrieval for up to two years in the past.



## OpenAPI

````yaml https://api.criteo.com/2025-04/marketingsolutions/open-api-specifications.json post /2025-04/transactions/report
openapi: 3.0.1
info:
  title: Criteo API
  description: Criteo API - MarketingSolutions
  version: 2025-04
servers:
  - url: https://api.criteo.com
security:
  - oauth: []
tags:
  - name: Advertiser
  - name: Analytics
  - name: Audience
  - name: Campaign
  - name: Creative
  - name: Gateway
paths:
  /2025-04/transactions/report:
    post:
      tags:
        - Analytics
      summary: /2025-04/transactions/report
      description: "This Transactions endpoint provides transactions id related data.\r\n<br/><br/>\r\nThis endpoint supports data retrieval for up to two years in the past."
      operationId: GetTransactionsReport
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TransactionsReportQueryMessageListRequest'
            example:
              data:
                - type: report
                  attributes:
                    advertiserIds: 123,456,789
                    eventType: Display
                    currency: EUR
                    format: csv
                    timezone: Europe/Paris
                    startDate: '2024-01-01T00:00:00.0000000+00:00'
                    endDate: '2024-01-04T00:00:00.0000000+00:00'
          application/xml:
            schema:
              $ref: '#/components/schemas/TransactionsReportQueryMessageListRequest'
            example: "<ValueResourceCollectionInputOfTransactionsReportQueryMessagetukRIHCU xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Resources\">\r\n  <Data>\r\n    <ValueResourceOfTransactionsReportQueryMessagetukRIHCU>\r\n      <Attributes xmlns:d4p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Messages\">\r\n        <d4p1:EndDate>2024-01-04T00:00:00</d4p1:EndDate>\r\n        <d4p1:StartDate>2024-01-01T00:00:00</d4p1:StartDate>\r\n        <d4p1:Format>csv</d4p1:Format>\r\n        <d4p1:Timezone>Europe/Paris</d4p1:Timezone>\r\n        <d4p1:AdvertiserIds>\r\n          <d4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n            <d6p1:int>123</d6p1:int>\r\n            <d6p1:int>456</d6p1:int>\r\n            <d6p1:int>789</d6p1:int>\r\n          </d4p1:Values>\r\n        </d4p1:AdvertiserIds>\r\n        <d4p1:Currency>EUR</d4p1:Currency>\r\n        <d4p1:EventType>Display</d4p1:EventType>\r\n        <d4p1:IsInternal>false</d4p1:IsInternal>\r\n      </Attributes>\r\n      <Type>report</Type>\r\n    </ValueResourceOfTransactionsReportQueryMessagetukRIHCU>\r\n  </Data>\r\n</ValueResourceCollectionInputOfTransactionsReportQueryMessagetukRIHCU>"
          text/xml:
            schema:
              $ref: '#/components/schemas/TransactionsReportQueryMessageListRequest'
            example: "<ValueResourceCollectionInputOfTransactionsReportQueryMessagetukRIHCU xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Resources\">\r\n  <Data>\r\n    <ValueResourceOfTransactionsReportQueryMessagetukRIHCU>\r\n      <Attributes xmlns:d4p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Messages\">\r\n        <d4p1:EndDate>2024-01-04T00:00:00</d4p1:EndDate>\r\n        <d4p1:StartDate>2024-01-01T00:00:00</d4p1:StartDate>\r\n        <d4p1:Format>csv</d4p1:Format>\r\n        <d4p1:Timezone>Europe/Paris</d4p1:Timezone>\r\n        <d4p1:AdvertiserIds>\r\n          <d4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n            <d6p1:int>123</d6p1:int>\r\n            <d6p1:int>456</d6p1:int>\r\n            <d6p1:int>789</d6p1:int>\r\n          </d4p1:Values>\r\n        </d4p1:AdvertiserIds>\r\n        <d4p1:Currency>EUR</d4p1:Currency>\r\n        <d4p1:EventType>Display</d4p1:EventType>\r\n        <d4p1:IsInternal>false</d4p1:IsInternal>\r\n      </Attributes>\r\n      <Type>report</Type>\r\n    </ValueResourceOfTransactionsReportQueryMessagetukRIHCU>\r\n  </Data>\r\n</ValueResourceCollectionInputOfTransactionsReportQueryMessagetukRIHCU>"
          application/*+xml:
            schema:
              $ref: '#/components/schemas/TransactionsReportQueryMessageListRequest'
            example: "<ValueResourceCollectionInputOfTransactionsReportQueryMessagetukRIHCU xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Resources\">\r\n  <Data>\r\n    <ValueResourceOfTransactionsReportQueryMessagetukRIHCU>\r\n      <Attributes xmlns:d4p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Messages\">\r\n        <d4p1:EndDate>2024-01-04T00:00:00</d4p1:EndDate>\r\n        <d4p1:StartDate>2024-01-01T00:00:00</d4p1:StartDate>\r\n        <d4p1:Format>csv</d4p1:Format>\r\n        <d4p1:Timezone>Europe/Paris</d4p1:Timezone>\r\n        <d4p1:AdvertiserIds>\r\n          <d4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n            <d6p1:int>123</d6p1:int>\r\n            <d6p1:int>456</d6p1:int>\r\n            <d6p1:int>789</d6p1:int>\r\n          </d4p1:Values>\r\n        </d4p1:AdvertiserIds>\r\n        <d4p1:Currency>EUR</d4p1:Currency>\r\n        <d4p1:EventType>Display</d4p1:EventType>\r\n        <d4p1:IsInternal>false</d4p1:IsInternal>\r\n      </Attributes>\r\n      <Type>report</Type>\r\n    </ValueResourceOfTransactionsReportQueryMessagetukRIHCU>\r\n  </Data>\r\n</ValueResourceCollectionInputOfTransactionsReportQueryMessagetukRIHCU>"
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: string
                format: binary
            text/csv:
              schema:
                type: string
                format: binary
            text/xml:
              schema:
                type: string
                format: binary
            application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
              schema:
                type: string
                format: binary
      security:
        - oauth:
            - MarketingSolutions_Analytics_Read
components:
  schemas:
    TransactionsReportQueryMessageListRequest:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/TransactionsReportQueryMessageResource'
          nullable: true
      additionalProperties: false
      description: >-
        A top-level object that encapsulates a Criteo API request for several
        value objects.
    TransactionsReportQueryMessageResource:
      type: object
      properties:
        attributes:
          $ref: '#/components/schemas/TransactionsReportQueryMessage'
        type:
          type: string
          description: Type of the resource.
          nullable: true
      additionalProperties: false
      description: A value resource exposed by the API.
    TransactionsReportQueryMessage:
      required:
        - advertiserIds
        - currency
        - endDate
        - startDate
      type: object
      properties:
        advertiserIds:
          type: string
          description: >-
            List of advertiser IDs to report on, provided as a single
            comma-separated string (e.g., "123,456,789"). The advertisers must
            already exist. If empty, all advertisers will be used.
        currency:
          type: string
          description: >-
            The currency used for the report. ISO 4217 code (three-letter
            capitals).
        endDate:
          type: string
          description: >-
            End date of the report. Date component of ISO 8601 format, any time
            or timezone component is ignored.
          format: date-time
        eventType:
          enum:
            - Click
            - Display
          type: string
          description: >-
            Optional event type to filter on. If empty, all event types will be
            included.
          nullable: true
        format:
          enum:
            - csv
            - excel
            - xml
            - json
          type: string
          description: Optional file format of the generated report.
          default: json
        startDate:
          type: string
          description: >-
            Start date of the report. Date component of ISO 8601 format, any
            time or timezone component is ignored. Must be ≤ endDate.
          format: date-time
        timezone:
          type: string
          description: >-
            Optional timezone used for the report. Timezone Database format
            (Tz).
          default: UTC
          nullable: true
      additionalProperties: false
      description: This is the message defining the query for Transaction report
  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: {}

````