# Start a report job

> POST /reports/jobs

Source: https://docs.trykintsugi.com/reference/2026-10-06/start-a-report-job

POST /reports/jobs

Start a report job

Start generating a report for the resolved organization and return `202` with the job's id. The report is generated asynchronously: poll `GET /reports/jobs/{reportJobId}` for its status, then `GET /reports/jobs/{reportJobId}/download` once it is `READY`. `reportArgs` is shaped by `reportType`; an organization may have at most 5 report jobs queued or processing at once. Set `deliveryMethod` to `EMAIL` to get a download link by email instead of fetching it yourself. A `VAT_REPORT` job is read back as JSON from `GET /reports/jobs/{reportJobId}/result`; it needs VAT accounts payable enabled on the organization (else `403`) and a DE, GB, CZ, ES, or SG filing (else `400`).

Category: Reports

Request body:
deliveryMethod (ReportDeliveryMethodEnum) - `DOWNLOAD` (default) stores the report for `GET /reports/jobs/{reportJobId}/download`. `EMAIL` emails a download link to the address of the user behind your credential; the address cannot be set in the request. Not available for `BULK_FILING_REPORTS` or `VAT_REPORT`.
  allowed values: DOWNLOAD, EMAIL
reportType (string, required) - Which report to generate.
reportArgs (NexusReportArgs) - No filters for this report type.

Response fields:
reportJobId (string, required) - Id of the new report job.
status (PublicReportJobStatusEnum) - Always `QUEUED` on creation.
  allowed values: QUEUED, PROCESSING, READY, FAILED
reportType (PublicReportTypeEnum, required) - The report type this job will generate, echoed back from the request.
  allowed values: NEXUS, TRANSACTIONS_SUMMARY, TRANSACTIONS_DETAILS, FILINGS_SUMMARY, FILINGS, FILING_DETAILS, BULK_FILING_REPORTS, PRODUCTS, COLLECTED_TRANSACTIONS, VAT_REPORT
deliveryMethod (ReportDeliveryMethodEnum) - How the report will be delivered, echoed back from the request.
  allowed values: DOWNLOAD, EMAIL

Response statuses: 202, 400, 401, 403, 404, 422, 429, 503

---

Index of every page: https://docs.trykintsugi.com/llms.txt