---
title: "Create report generation job"
method: POST
path: "/reports"
tags: ["Reports"]
---

# Create report generation job

`POST /reports`

Creates an asynchronous report job. Download the report once the job status is COMPLETED.

## Request body

- union
  - object
    - `type` 'PAYOUT_STATEMENT', required
    - `params` object, required
      - `payoutId` string, required — Payout identifier
      - `teamId` string — Requesting team identifier
  - object
    - `type` 'PAYOUT_ORDER_BREAKDOWN', required
    - `params` object, required
      - `payoutId` string, required — Payout identifier
      - `teamId` string — Requesting team identifier
  - object
    - `type` 'PAYOUT_BOOKING_FEE_BREAKDOWN', required
    - `params` object, required
      - `payoutId` string, required — Payout identifier
      - `teamId` string — Requesting team identifier
  - object
    - `type` 'PAYOUT_ADJUSTMENT_BREAKDOWN', required
    - `params` object, required
      - `payoutId` string, required — Payout identifier
      - `teamId` string — Requesting team identifier
  - object
    - `type` 'EVENT_ORDERS', required
    - `params` object, required
      - `eventId` string, required — Event identifier

## Response `200`

OK

- object
  - `id` string, required
  - `type` 'PAYOUT_STATEMENT' | 'PAYOUT_ORDER_BREAKDOWN' | 'PAYOUT_BOOKING_FEE_BREAKDOWN' | 'PAYOUT_ADJUSTMENT_BREAKDOWN' | 'EVENT_ORDERS', required
  - `status` 'QUEUED' | 'PROCESSING' | 'COMPLETED' | 'FAILED', required
  - `createdAt` string, required
  - `updatedAt` string, required
  - `expiresAt` string
  - `filename` string
  - `contentType` string
  - `sizeBytes` number
  - `error` string
  - `downloadUrl` string

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404
- `409` — 409
- `412` — 412
- `422` — 422
- `429` — 429
- `500` — 500
- `501` — 501
- `503` — 503

---

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