> ## 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. # /preview/reports/async-statistics > This Statistics endpoint provides an export Id that let you retrieve data. ## OpenAPI ````yaml https://api.criteo.com/preview/marketingsolutions/open-api-specifications.json post /preview/reports/async-statistics openapi: 3.0.1 info: title: Criteo API description: Criteo API - MarketingSolutions version: Preview servers: - url: https://api.criteo.com security: - oauth: [] tags: - name: Advertiser - name: Analytics - name: Audience - name: Campaign - name: Catalog - name: Creative - name: Gateway - name: OnSiteRecommendation - name: Reco paths: /preview/reports/async-statistics: post: tags: - Analytics summary: /preview/reports/async-statistics description: >- This Statistics endpoint provides an export Id that let you retrieve data. operationId: GetAsyncAdsetReport requestBody: content: application/json: schema: $ref: '#/components/schemas/GenerateStatisticsReportRequest' application/xml: schema: $ref: '#/components/schemas/GenerateStatisticsReportRequest' text/xml: schema: $ref: '#/components/schemas/GenerateStatisticsReportRequest' application/*+xml: schema: $ref: '#/components/schemas/GenerateStatisticsReportRequest' required: true responses: '202': description: Success content: application/json: schema: $ref: '#/components/schemas/MarketingSolutionsReportStatusResponse' application/xml: schema: $ref: '#/components/schemas/MarketingSolutionsReportStatusResponse' text/xml: schema: $ref: '#/components/schemas/MarketingSolutionsReportStatusResponse' security: - oauth: - MarketingSolutions_Analytics_Read components: schemas: GenerateStatisticsReportRequest: type: object properties: data: $ref: '#/components/schemas/GenerateStatisticsReportResource' additionalProperties: false description: >- A top-level object that encapsulates a Criteo API request for a single value object. MarketingSolutionsReportStatusResponse: type: object properties: data: $ref: '#/components/schemas/MarketingSolutionsReportStatusResource' errors: type: array items: $ref: '#/components/schemas/CommonProblem' description: Errors that occured during this call. nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: >- A top-level object that encapsulates a Criteo API response for a single entity. GenerateStatisticsReportResource: type: object properties: attributes: $ref: '#/components/schemas/GenerateStatisticsReport' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. MarketingSolutionsReportStatusResource: type: object properties: attributes: $ref: '#/components/schemas/MarketingSolutionsReportStatus' id: type: string description: Unique id of the entity. nullable: true type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A domain entity exposed by the API, identified by a unique id. nullable: true 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. GenerateStatisticsReport: required: - advertiserIds - dimensions - endDate - metrics - startDate type: object properties: adSetIds: type: array items: 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. nullable: true adSetNames: type: array items: type: string description: The list of ad sets names. If empty, all the adSets will be fetched. nullable: true adSetStatus: type: array items: type: string description: >- The list of ad sets status. If empty, all the adSets will be fetched. nullable: true advertiserIds: type: array items: type: string description: The list of advertiser ids currency: type: string description: >- The currency used for the report. ISO 4217 code (three-letter capitals). nullable: true dimensions: minItems: 1 type: array items: enum: - AdvertiserId - Advertiser - CampaignId - Campaign - AdSetId - AdSet - ChannelId - Channel - CategoryId - Category - Device - Os - AdId - Ad - CouponId - Coupon - Year - Month - Week - Day - Hour - MarketingCampaignGoal - MarketingObjective - MarketingObjectiveId - VideoPlayerSize - VideoPlacement - VideoPlaybackMethod - SSP - VideoDurationInSeconds - MediaType - AdFormat - DisplaySize - VideoPlayerRatio - Country - Region - PostalCode - UserBehavior - Environment - AdChannel - SocialPlatform type: string description: The dimensions for the report. endDate: type: string description: >- End date of the report. Date component of ISO 8061 format, any time or timezone component is ignored. format: date-time metrics: type: array items: enum: - Clicks - Displays - AdvertiserCost - SalesPc30dClientAttribution - SalesAllPc30dClientAttribution - SalesClientAttribution - SalesAllClientAttribution - SalesPc30d - SalesAllPc30d - SalesPc1d - SalesAllPc1d - SalesPc7d - SalesAllPc7d - SalesPc7dPv24 - SalesAllPc7dPv24 - SalesPv24h - SalesAllPv24h - SalesPc30Pv24 - SalesAllPc30Pv24 - SalesPc30dPv24h - SalesAllPc30dPv24h - SalesPiPc - SalesPiPv - SalesPiPcPv - PostInstallSales - SalesOfflinePc - SalesOfflinePv - SalesOfflinePc30d - SalesOfflinePv24h - RevenueGeneratedPc30dClientAttribution - RevenueGeneratedAllPc30dClientAttribution - RevenueGeneratedClientAttribution - RevenueGeneratedAllClientAttribution - RevenueGeneratedPc30d - RevenueGeneratedAllPc30d - RevenueGeneratedPc1d - RevenueGeneratedAllPc1d - RevenueGeneratedPc7d - RevenueGeneratedAllPc7d - RevenueGeneratedPv24h - RevenueGeneratedAllPv24h - RevenueGeneratedPc30Pv24 - RevenueGeneratedAllPc30Pv24 - RevenueGeneratedPc30dPv24h - RevenueGeneratedAllPc30dPv24h - RevenueGeneratedPc7dPv24 - RevenueGeneratedAllPc7dPv24 - RevenueGeneratedOfflinePc - RevenueGeneratedOfflinePv - RevenueGeneratedOfflinePc30d - RevenueGeneratedOfflinePv24h - ConversionRatePc30dClientAttribution - ConversionRateAllPc30dClientAttribution - ConversionRateClientAttribution - ConversionRateAllClientAttribution - ConversionRatePc30d - ConversionRateAllPc30d - ConversionRatePc1d - ConversionRateAllPc1d - ConversionRatePc7d - ConversionRateAllPc7d - ConversionRatePv24h - ConversionRateAllPv24h - ConversionRatePc30Pv24 - ConversionRateAllPc30Pv24 - ConversionRatePc30dPv24h - ConversionRateAllPc30dPv24h - ConversionRatePc7dPv24 - ConversionRateAllPc7dPv24 - ConversionRatePiPcPv - PostInstallConversionRate - ECosPc30dClientAttribution - ECosAllPc30dClientAttribution - ECosClientAttribution - ECosAllClientAttribution - ECosPc30d - ECosAllPc30d - ECosPc1d - ECosAllPc1d - ECosPc7d - ECosAllPc7d - ECosPv24h - ECosAllPv24h - ECosPc30Pv24 - ECosAllPc30Pv24 - ECosPc30dPv24h - ECosAllPc30dPv24h - ECosPc7dPv24 - ECosAllPc7dPv24 - CostPerOrderPc30dClientAttribution - CostPerOrderAllPc30dClientAttribution - CostPerOrderClientAttribution - CostPerOrderAllClientAttribution - CostPerOrderPc30d - CostPerOrderAllPc30d - CostPerOrderPc1d - CostPerOrderAllPc1d - CostPerOrderPc7d - CostPerOrderAllPc7d - CostPerOrderPv24h - CostPerOrderAllPv24h - CostPerOrderPc30Pv24 - CostPerOrderAllPc30Pv24 - CostPerOrderPc30dPv24h - CostPerOrderAllPc30dPv24h - CostPerOrderPc7dPv24 - CostPerOrderAllPc7dPv24 - ExposedUsers - Audience - Reach - AverageCartPc30dClientAttribution - AverageCartAllPc30dClientAttribution - AverageCartClientAttribution - AverageCartAllClientAttribution - AverageCartPc30d - AverageCartAllPc30d - AverageCartPv24h - AverageCartAllPv24h - AverageCartPc1d - AverageCartAllPc1d - AverageCartPc7d - AverageCartAllPc7d - AverageCartPc30Pv24 - AverageCartAllPc30Pv24 - AverageCartPc30dPv24h - AverageCartAllPc30dPv24h - AverageCartPc7dPv24 - AverageCartAllPc7dPv24 - ClickThroughRate - ECpc - Cpc - ECpm - ReturnOnAdvertisingSpendingClientAttribution - ReturnOnAdvertisingSpendingAllClientAttribution - AdvertiserValue - AdvertiserAllValue - CostOfAdvertiserValue - CostOfAdvertiserValueAll - AppInstallsPcPv - AppInstalls - QualifiedVisits - Visits - OrderValuePi - PostInstallOrderValue - BounceRate - CostPerInstallPcPv - CostPerInstall - CostPerVisit - InstallRatePcPv - InstallRate - OmnichannelRoasPc30d - OmnichannelRoasAllPc30d - OmnichannelRevenuePc30d - OmnichannelRevenueAllPc30d - OmnichannelSalesPc30d - OmnichannelSalesAllPc30d - OmnichannelRoasAllPv24h - OmnichannelRoasPv24h - OmnichannelRevenueAllPv24h - OmnichannelRevenuePv24h - OmnichannelSalesAllPv24h - OmnichannelSalesPv24h - OmnichannelRoasClientAttribution - OmnichannelRevenueClientAttribution - OmnichannelSalesClientAttribution - RoasAllPc30dClientAttribution - RoasPc30dClientAttribution - RoasAllClientAttribution - RoasClientAttribution - RoasAllPc30d - RoasPc30d - RoasAllPc7d - RoasPc7d - RoasAllPc1d - RoasPc1d - RoasAllPv24h - RoasPv24h - RoasPc30Pv24 - RoasAllPc30Pv24 - RoasPc30dPv24h - RoasAllPc30dPv24h - RoasPc7dPv24 - RoasAllPc7dPv24 - CostOfSalePi - CostPerOrderPi - PostInstallCostOfSale - PostInstallCostPerOrder - ReturnOnAdvertiserSpendingPi - PostInstallRoas - ReturnOnAdvertiserSpendingOfflinePc - ReturnOnAdvertiserSpendingOfflinePv - RoasOfflinePc30d - RoasOfflinePv24h - PotentialDisplays - OverallCompetitionWin - ViewableDisplays - NonViewableDisplays - UntrackableDisplays - Frequency - InvalidClicks - InvalidDisplays - ResultType - CostPerQualifiedVisit - CostPerVisitPV1D - VisitsPV1D - AssistsPc30dClientAttribution - AssistsAllPc30dClientAttribution - AssistsClientAttribution - AssistsAllClientAttribution - AssistsPc30d - AssistsAllPc30d - AssistsPc1d - AssistsAllPc1d - AssistsPc7d - AssistsAllPc7d - AssistsPc7dPv24 - AssistsAllPc7dPv24 - AssistsPc7dPv24h - AssistsAllPc7dPv24h - AssistsPv24h - AssistsAllPv24h - AssistsPc30Pv24 - AssistsAllPc30Pv24 - AssistsPc30dPv24h - AssistsAllPc30dPv24h - AssistsPiPc - AssistsPiPv - AssistsPiPcPv - AssistsSalesRatioPc30dClientAttribution - AssistsSalesRatioAllPc30dClientAttribution - AssistsSalesRatioClientAttribution - AssistsSalesRatioAllClientAttribution - AssistsSalesRatioPc30d - AssistsSalesRatioAllPc30d - AssistsSalesRatioPc1d - AssistsSalesRatioAllPc1d - AssistsSalesRatioPc7d - AssistsSalesRatioAllPc7d - AssistsSalesRatioPc7dPv24 - AssistsSalesRatioAllPc7dPv24 - AssistsSalesRatioPc7dPv24h - AssistsSalesRatioAllPc7dPv24h - AssistsSalesRatioPv24h - AssistsSalesRatioAllPv24h - AssistsSalesRatioPc30Pv24 - AssistsSalesRatioAllPc30Pv24 - AssistsSalesRatioPc30dPv24h - AssistsSalesRatioAllPc30dPv24h - AssistsSalesRatioPiPc - AssistsSalesRatioPiPv - AssistsSalesRatioPiPcPv - SalesLc - SalesAllLc - RevenueGeneratedLc - RevenueGeneratedAllLc type: string description: The list of metrics to report. startDate: type: string description: >- Start date of the report. Date component of ISO 8061 format, any time or timezone component is ignored. format: date-time timezone: type: string description: >- Optional timezone used for the report. Timezone Database format (Tz). nullable: true additionalProperties: false description: Request attributes for async statistics report MarketingSolutionsReportStatus: type: object properties: message: type: string nullable: true status: enum: - Unknown - Pending - Done - Failure - Expired type: string nullable: true additionalProperties: false description: >- Object containing the status of report request and an associated message. nullable: true 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: {} ````