# Report generated

Webhook sent when a report finishes generating and is ready to download.

Endpoint: POST ReportGenerated
Version: 2.0.0
Security: signatureAuth

## Security:

  - `signatureAuth` (unknown)
    apiKey in header Signature

## Request fields (application/json):

  - `event_id` (string, required)
    Unique event identifier.
    Example: 1319670b-a6cc-4572-aa75-2dac3b3fc04d

  - `event_type` (string, required)
    Event type.
    Enum: "REPORT_GENERATED"

  - `occurred_at` (string, required)
    Date and time when the event occurred.
    Example: 2026-04-03T16:18:40.000000Z

  - `data` (object, required)
    Event payload containing the generated report record.

  - `data.report` (object, required)
    Represents a report created under the current API key.
    Example: {"id":"rprt_01K8F3ZQ8X9YBCDEFGHJKMNPQR","report_type":"INVOICES","status":"PROCESSING","created_at":"2024-01-01T00:00:00.000000Z","updated_at":"2024-01-01T00:10:00.000000Z","parameters":{"date_from":"…

  - `data.report.id` (string, required)
    Unique report identifier.
    Example: rprt_01K8F3ZQ8X9YBCDEFGHJKMNPQR

  - `data.report.report_type` (string, required)
    Report type.
The list of enum values may be extended without notice.
    Enum: "INVOICES", "SUBSCRIPTIONS", "TAX_TRANSACTIONAL", "INVOICE_PAYMENTS", "TAX_SUMMARY"

  - `data.report.status` (string, required)
    Current report status.
The list of enum values may be extended without notice.
    Enum: "PROCESSING", "SUCCEEDED", "FAILED", "EXPIRED"

  - `data.report.created_at` (string, required)
    Date and time when the report was created.
    Example: 2024-01-01T00:00:00.000000Z

  - `data.report.updated_at` (string, required)
    Date and time when the report was last updated.
    Example: 2024-01-01T00:10:00.000000Z

  - `data.report.parameters` (object, required)
    Parameters the report was created with.
    Example: {"channel_ids":["chn_01JYWX6Z5A8P32B6NVH1G9876A"],"date_from":"2024-01-01T00:00:00.000000Z","date_to":"2024-02-01T00:00:00.000000Z"}

  - `data.report.parameters.channel_ids` (array)
    Channels the report is limited to. Absent when the report covers the entire account.
    Example: ["chn_01JYWX6Z5A8P32B6NVH1G9876A"]

  - `data.report.parameters.date_from` (string, required)
    Start date and time for the report data range.
    Example: 2024-01-01T00:00:00.000000Z

  - `data.report.parameters.date_to` (string, required)
    End date and time for the report data range.
    Example: 2024-02-01T00:00:00.000000Z

## Request examples:

  - `reportGenerated` (unknown)

## Response 200:

  - `200` (unknown)
    OK

