---
title: "/2026-01/retail-media/reports/unfilled-placements"
method: POST
path: "/2026-01/retail-media/reports/unfilled-placements"
tags: ["Analytics"]
---

# /2026-01/retail-media/reports/unfilled-placements

`POST /2026-01/retail-media/reports/unfilled-placements`

Returns an asynchronous Unfilled Placements Report
<br />
This endpoint is subject to specific rate limits.

## Request body

- AsyncUnfilledPlacementsReportRequest — A top-level object that encapsulates a Criteo API request for a single value
  - `data` AsyncUnfilledPlacementsReportResource — A top-level object that encapsulates a Criteo API response for a single value
    - `attributes` AsyncUnfilledPlacementsReport — Async Unfilled Placements report body request
      - `adServerType` 'all' | 'gam' | 'criteo' — Filter on the type of the ad server: criteo, gam, all
      - `campaignType` 'all' | 'sponsoredProducts' | 'onSiteDisplays' — Filter on the type of the campaign: onsite display, onsite sponsored products, all
      - `dimensions` string[], required — List of dimensions to report on
      - `endDate` string, date-time, required — End date
      - `format` 'json' | 'json-compact' | 'json-newline' | 'csv' — Format of the output
      - `metrics` string[], required — List of metrics to report on
      - `startDate` string, date-time, required — Start date
      - `supplyAccountIds` string[], required — Supply account ids to report on
      - `timezone` string — Time zone : see criteo developer portal for supported time zones
    - `type` string

## Response `200`

Success

- AsyncReportResponse — Async Report response format
  - `data` StatusResponseResource, nullable — A class that represents a domain entity exposed by an API
    - `attributes` StatusResponse, nullable — Status of an async report request
      - `createdAt` string, nullable
      - `expiresAt` string, nullable
      - `fileSizeBytes` integer, nullable
      - `id` string, nullable
      - `md5CheckSum` string, nullable
      - `message` string, nullable
      - `rowCount` integer, nullable
      - `status` 'pending' | 'success' | 'failure' | 'expired', nullable
    - `id` string, nullable
    - `type` string, nullable
  - `errors` CommonProblem[], nullable
    - `code` string, nullable — A machine-readable error code, expressed as a string value.
    - `detail` string, nullable — A human-readable explanation specific to this occurrence of the problem
    - `instance` string, nullable — A URI that identifies the specific occurrence of the problem.
    - `source` object, nullable — A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable
    - `title` string, nullable — A short human-readable description of the problem type
    - `traceId` string, nullable — The request correlation ID this problem comes from.
    - `traceIdentifier` string, nullable — The request correlation ID this problem comes from. (deprecated, use traceId instead)
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable — The problem's category.
  - `warnings` CommonProblem[], nullable
    - `code` string, nullable — A machine-readable error code, expressed as a string value.
    - `detail` string, nullable — A human-readable explanation specific to this occurrence of the problem
    - `instance` string, nullable — A URI that identifies the specific occurrence of the problem.
    - `source` object, nullable — A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable
    - `title` string, nullable — A short human-readable description of the problem type
    - `traceId` string, nullable — The request correlation ID this problem comes from.
    - `traceIdentifier` string, nullable — The request correlation ID this problem comes from. (deprecated, use traceId instead)
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable — The problem's category.

---

[API](https://skmtc.net/criteo/apis/criteo-api.md) · [All operations](https://skmtc.net/criteo/apis/criteo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/criteo/criteo-api/revisions/c1721589426a/schema)