Create an async report job
Triggers an async report job. Returns 202 Accepted with the job
id and status: 'pending'. Poll GET /v1/reports/{id} until
status: 'complete', then call GET /v1/reports/{id}/download
for the result. Requires the reports:write scope. Industry
parallel: Stripe Reporting API POST /v1/reporting/report_runs.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Headers
Client-generated unique key for idempotent POST/PATCH/DELETE operations. Alias for the Idempotency parameter. Max 255 chars. On retry with the same key, the original response is returned without re-executing the operation. Keys expire after 24 hours.
255Body
One of the keys returned by GET /v1/reports/types.
Report-specific filter parameters. Schema depends on report_type
(see GET /v1/reports/types). All report types accept the optional
include_historical boolean (default true): set false to
EXCLUDE migration-backfill rows (is_historical_import = true)
so revenue / sales aggregations reflect the LIVE business only.
Aging reports (ar_aging / ap_aging) accept it for surface
consistency but treat it as a no-op (an open balance is owed
regardless of import origin).
json, csv, xlsx, pdf 
