# Report Events (API)
source: https://developer.mastercard.com/open-finance-us/documentation/webhooks/webhooks-report/report-webhooks-api/index.md

API report webhook notifications are sent for reports generated using a request to an API endpoint.
Note: Notifications are sent to the webhook URL you specified using the `callbackUrl` request parameter in your generate report API call. See [Generating Reports](https://developer.mastercard.com/open-finance-us/documentation/products/lend/generating-reports/index.md).

Notifications are sent when a report starts, fails, or completes.

This page provides example webhook notifications for [supported reports](https://developer.mastercard.com/open-finance-us/documentation/products/lend/reports/index.md).
Sent when a report is being generated.
* JSON

```JSON
{
"eventName": "inProgress",
"id": "REPORT_ID",
"consumerId": "CONSUMER_ID",
"consumerSsn": "1234",
"type": "voaHistory",
"status": "inProgress",
"portfolioId": "PORTFOLIO_ID",
"customerId": 123456,
"reportCustomFields": [
    {
    "label": "label 0",
    "value": "value 0",
    "shown": false
    }
]
}
```

Sent after a report has failed to generate.
* JSON

```JSON
{
"eventName": "failed",
"id": "REPORT_ID",
"consumerId": "CONSUMER_ID",
"consumerSsn": "1234",
"type": "voi",
"status": "failed",
"portfolioId": "PORTFOLIO_ID",
"customerId": 123456,
"reportCustomFields": [
    {
    "label": "label 0",
    "value": "value 0",
    "shown": false
    }
]
}
```

Sent when a report is complete.
* JSON

```JSON
{
"eventName": "done",
"id": "REPORT_ID",
"consumerId": "CONSUMER_ID",
"consumerSsn": "1234",
"type": "voa",
"status": "success",
"portfolioId": "PORTFOLIO_ID",
"customerId": 123456,
"reportCustomFields": [
    {
    "label": "label 0",
    "value": "value 0",
    "shown": false
    }
]
}
```