---
title: "/2026-01/retail-media/billing/partner-report"
method: POST
path: "/2026-01/retail-media/billing/partner-report"
tags: ["Billing"]
---

# /2026-01/retail-media/billing/partner-report

`POST /2026-01/retail-media/billing/partner-report`

## Request

- Base URL: `https://api.criteo.com`
- URL: `https://api.criteo.com/2026-01/retail-media/billing/partner-report`
- Auth: OAuth 2
  - Authorization code: `https://api.criteo.com/oauth2`
  - Client credentials
  - Token URL: `https://api.criteo.com/oauth2/token` scopes: `RetailMedia_Billing_Read`
- TypeScript: <https://skmtc.dev/criteo/apis/criteo-api/docs/2026-01/retail-media/billing/partner-report/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a Partner Billing Report request.

## Request body

- ValueResourceInputPartnerBillingReportRequestV1: A top-level object that encapsulates a Criteo API request for a single value object.
  - `data` ValueResourcePartnerBillingReportRequestV1: A value resource exposed by the API.
    - `attributes` PartnerBillingReportRequestV1: The request object of a Partner Billing Report.
      - `accountIds` string[], nullable: On which accounts the report is created.
      - `endDate` string, date, required: End date of the report (ISO 8601 format, e.g. YYYY-MM-DD).
      - `format` 'json' | 'csv': Format type of the report.
      - `retailerIds` integer[], nullable: On which retailers the report is created.
      - `startDate` string, date, required: Start date of the report (ISO 8601 format, e.g. YYYY-MM-DD).
    - `type` string, nullable: Type of the resource.

## Response `201`

Success

- EntityResourceOutcomePartnerBillingReportStatusV1: A top-level object that encapsulates a Criteo API response for a single entity.
  - `data` EntityResourcePartnerBillingReportStatusV1, nullable: A domain entity exposed by the API, identified by a unique id.
    - `attributes` PartnerBillingReportStatusV1, nullable: Status info of a Partner Billing Report.
      - `createdAt` string, date-time, required: The date when the report request is created.
      - `errorMessage` string, nullable: Possible error message along with the status.
      - `status` 'pending' | 'success' | 'failed' | 'expired', required: Status of the report.
    - `id` string, nullable: Unique id of the entity.
    - `type` string, nullable: Type of the resource.
  - `errors` SdkApiRestCommonProblem[], nullable: Errors that occured during this call.
    - `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.
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable: The problem's category.
  - `warnings` SdkApiRestCommonProblem[], nullable: Warnings that occured during this call.
    - `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.
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable: The problem's category.

---

[API](https://skmtc.dev/criteo/apis/criteo-api.md) - [All operations](https://skmtc.dev/criteo/apis/criteo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/criteo/apis/criteo-api/revisions/c1721589426a?raw)