# Ask for a report.

> Builds, in the background, one of your accounting exports over a period (UTC days, both included, 366 days at most), or a Lite or Relay seller's statement:

`POST https://api.wajub.com/sync/reports`

Builds, in the background, one of your accounting exports over a period (UTC days, both included, 366 days at most), or a Lite or Relay seller's statement:

- `payout_reconciliation` (CSV or XLSX): every element of every payout Wajub made to your sellers, one row each (sale, Wajub's fee, your commission, refund, cover, recovery, escrow released, payout fee…), with the payout's id, the operator's reference and the value date. The rows of a payout add up to its amount, to the centime.
- `seller_summary` (CSV or XLSX): per seller and currency, sales, refunds, lost disputes, commission taken and given back, paid out; and, as it is built, what they are owed, what is withheld and their cover debt.
- `platform_commission` (CSV or XLSX): your commission per month, seller and currency: taken, given back, net.
- `relay_dues` (CSV or XLSX): your Relay sellers' dues of the period, their state and the payout that paid them.
- `seller_statement` (PDF, `account` required): what was collected for the seller, refunded, kept as your commission and paid to them, per currency and month, in your brand, in English or French (`locale`).

A dispute the merchant accepted counts once, among the lost disputes, never also among the refunds. Columns are stable for a `format_version` (also in the file's name); amounts in major units with their currency; dates in ISO 8601, UTC. A report is built within a minute or two; you receive `report.ready`, then `GET /sync/reports/{id}` gives a download link. At most 5 reports are waiting at a time. A test key builds from test data. Called with your own key, never with `X-Sync`.

## Body (application/json)

- `type` (string, required, one of `payout_reconciliation`, `seller_summary`, `platform_commission`, `relay_dues`, `seller_statement`): What to build.
- `period_start` (string, required): First day covered, YYYY-MM-DD (UTC).
- `period_end` (string, required): Last day covered, YYYY-MM-DD (UTC), on or after `period_start`, 366 days at most after it.
- `format` (string, nullable, one of `csv`, `xlsx`, `pdf`): `csv` or `xlsx` for an export (required); `pdf` for a statement (the default).
- `account` (string, nullable): The seller's account `id`, for a `seller_statement` (a Lite or Relay account).
- `locale` (string, nullable, one of `en`, `fr`): The language of a `seller_statement`: `en` (the default) or `fr`. Exports (CSV, XLSX) are the same in both: their columns are stable.

## Responses

- `202`: Accepted
- `400`: Statement of a Direct account
- `403`: Forbidden
- `404`: Unknown account
- `422`: Unprocessable Content
- `429`: Five reports already waiting

## Example response (202)

```json
{
  "code": 202,
  "status": "Accepted",
  "message": "Report requested",
  "report": {
    "id": "rpt_Hq2Lw8Tz4Nc6Vb1Xk9RmPd3F",
    "object": "report",
    "type": "payout_reconciliation",
    "format": "csv",
    "format_version": 1,
    "period_start": "2026-11-01",
    "period_end": "2026-11-30",
    "account": null,
    "status": "pending",
    "row_count": null,
    "file_name": null,
    "file_size": null,
    "failure_reason": null,
    "requested_via": "api",
    "created_at": "2026-12-01T08:00:00+00:00",
    "completed_at": null,
    "expires_at": null,
    "url": null,
    "url_expires_at": null
  }
}
```
