> ## 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. # /experimental/retail-media/insights/{insight-id}/status > Returns the current status of an asynchronously generated insight report. Poll this endpoint until the status is `Success`, then download the report from the insight output endpoint. ## OpenAPI ````yaml https://api.criteo.com/experimental/retailmedia/open-api-specifications.json get /experimental/retail-media/insights/{insight-id}/status openapi: 3.0.1 info: title: Criteo API description: Criteo API - RetailMedia version: Experimental servers: - url: https://api.criteo.com security: - oauth: [] tags: - name: Accounts - name: Analytics - name: Audience - name: Balance - name: Campaign - name: Catalog - name: Gateway - name: OnSiteRecommendation - name: ThirdPartyAccounts paths: /experimental/retail-media/insights/{insight-id}/status: get: tags: - Analytics summary: /experimental/retail-media/insights/{insight-id}/status description: "Returns the current status of an asynchronously generated insight report. Poll this endpoint until the\r\nstatus is `Success`, then download the report from the insight output endpoint." operationId: GetInsightReportStatus parameters: - name: insight-id in: path description: >- The ID of the asynchronous insight report. Must be a valid ID format. required: true schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/AsyncInsightResponse' security: - oauth: - RetailMedia_Analytics_Read components: schemas: AsyncInsightResponse: type: object properties: data: $ref: '#/components/schemas/InsightStatusResponseResource' 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: >- Response returned by the asynchronous insight endpoints, carrying the insight report status. example: data: id: 12345678-90ab-cdef-1234-567890abcdef type: InsightStatus attributes: status: Success message: rows_count=1234 createdAt: '2026-07-01T12:00:00.0000000+00:00' expiresAt: '2026-07-08T12:00:00.0000000+00:00' rowCount: 1234 md5CheckSum: 0123456789abcdef0123456789abcdef fileSizeBytes: 154321 warnings: [] errors: [] InsightStatusResponseResource: type: object properties: attributes: $ref: '#/components/schemas/InsightStatusResponse' 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. InsightStatusResponse: type: object properties: createdAt: type: string description: When the insight report was created. nullable: true expiresAt: type: string description: When the insight report expires and can no longer be downloaded. nullable: true fileSizeBytes: type: integer description: Size of the generated report file in bytes, when available. format: int64 nullable: true md5CheckSum: type: string description: MD5 checksum of the generated report file, when available. nullable: true message: type: string description: Additional information about the report status, when available. nullable: true rowCount: type: integer description: Number of rows in the generated report, when available. format: int32 nullable: true status: enum: - Unknown - Pending - Success - Failure - Expired - Invalidated type: string description: Current status of the insight report. nullable: true additionalProperties: false description: Status of an asynchronous insight report request. nullable: true example: status: Success message: rows_count=1234 createdAt: '2026-07-01T12:00:00Z' expiresAt: '2026-07-08T12:00:00Z' rowCount: 1234 md5CheckSum: 0123456789abcdef0123456789abcdef fileSizeBytes: 154321 securitySchemes: oauth: type: oauth2 flows: clientCredentials: tokenUrl: https://api.criteo.com/oauth2/token scopes: RetailMedia_Accounts_Read: >- Grants Read access to the capabilities from the Accounts domain, for RetailMedia applications RetailMedia_Analytics_Read: >- Grants Read access to the capabilities from the Analytics domain, for RetailMedia applications RetailMedia_Audience_Manage: >- Grants Manage access to the capabilities from the Audience domain, for RetailMedia applications RetailMedia_Balance_Read: >- Grants Read access to the capabilities from the Balance domain, for RetailMedia applications RetailMedia_Campaign_Manage: >- Grants Manage access to the capabilities from the Campaign domain, for RetailMedia applications RetailMedia_Campaign_Read: >- Grants Read access to the capabilities from the Campaign domain, for RetailMedia applications RetailMedia_Catalog_Manage: >- Grants Manage access to the capabilities from the Catalog domain, for RetailMedia applications RetailMedia_Catalog_Read: >- Grants Read access to the capabilities from the Catalog domain, for RetailMedia applications RetailMedia_OnSiteRecommendation_Read: >- Grants Read access to the capabilities from the OnSiteRecommendation domain, for RetailMedia applications RetailMedia_ThirdPartyAccounts_Manage: >- Grants Manage access to the capabilities from the ThirdPartyAccounts domain, for RetailMedia applications authorizationCode: authorizationUrl: https://api.criteo.com/oauth2 tokenUrl: https://api.criteo.com/oauth2/token scopes: RetailMedia_Accounts_Read: >- Grants Read access to the capabilities from the Accounts domain, for RetailMedia applications RetailMedia_Analytics_Read: >- Grants Read access to the capabilities from the Analytics domain, for RetailMedia applications RetailMedia_Audience_Manage: >- Grants Manage access to the capabilities from the Audience domain, for RetailMedia applications RetailMedia_Balance_Read: >- Grants Read access to the capabilities from the Balance domain, for RetailMedia applications RetailMedia_Campaign_Manage: >- Grants Manage access to the capabilities from the Campaign domain, for RetailMedia applications RetailMedia_Campaign_Read: >- Grants Read access to the capabilities from the Campaign domain, for RetailMedia applications RetailMedia_Catalog_Manage: >- Grants Manage access to the capabilities from the Catalog domain, for RetailMedia applications RetailMedia_Catalog_Read: >- Grants Read access to the capabilities from the Catalog domain, for RetailMedia applications RetailMedia_OnSiteRecommendation_Read: >- Grants Read access to the capabilities from the OnSiteRecommendation domain, for RetailMedia applications RetailMedia_ThirdPartyAccounts_Manage: >- Grants Manage access to the capabilities from the ThirdPartyAccounts domain, for RetailMedia applications ````