> For the complete documentation index, see [llms.txt](https://docs.aquanow.io/cams/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aquanow.io/cams/webhooks/reports.md).

# Reports

 The `firstFilePath` field indicates the full file path for the first file in the set. The `0001` at the end represent the file number, and so using the `fileCount` all files can be referenced using the `firstFilePath`

For the example below, the 1st file would be at the following path:

```
/reports/tax_notice/tax_notices_2024-10-01_2023-10-31_0001.zip
```

And the last file would be at:

```
/reports/tax_notice/tax_notices_2024-10-01_2023-10-31_0010.zip
```

### Tax Notices

<mark style="color:green;">`POST`</mark>&#x20;

Notifies that a batch of tax notices are ready.

**Body**

```json
{
  "messageId": "18fed079-477c-4844-a8f5-2c0075c5136f",
  "messageType": "TAX_NOTICES_READY",
  "messageTime": "2024-11-01T01:24:03.102Z",
  "message": {
    "reportStartPeriod": "2024-10-01",
    "reportEndPeriod": "2024-10-31",
    "firstFilePath": "/reports/tax_notice/tax_notices_2024-10-01_2023-10-31_0001.zip",
    "fileCount": 10
  }
}
```

### Statements

<mark style="color:green;">`POST`</mark>&#x20;

Notifies that a batch of statements are ready

**Body**

```json
{
  "messageId": "18fed079-477c-4844-a8f5-2c0075c5136f",
  "messageType": "STATEMENTS_READY",
  "messageTime": "2024-11-01T01:24:03.102Z",
  "message": {
    "reportStartPeriod": "2024-10-01",
    "reportEndPeriod": "2024-10-31",
    "firstFilePath": "/reports/statements/statements_2024-10-01_2023-10-31_0001.zip",
    "fileCount": 10
  }
}
```

### Reports

<mark style="color:green;">`POST`</mark>&#x20;

Notifies when various daily or monthly reports are available

**Body**

```json
{
  "messageId": "18fed079-477c-4844-a8f5-2c0075c5136f",
  "messageType": "REPORT_READY",
  "messageTime": "2023-12-14T01:24:03.102Z",
  "message": {
    "reportId": "132afd8d-8b1c-42b1-a909-ccdaf5080e44",
    "reportType": "monthly_transaction_report",
    "reportingPeriod": "2024-01-01",
    "generatedAt": "2024-01-01 01:24:03.102Z",
    "reportPath": "/reports/2026-01-01/132afd8d-8b1c-42b1-a909-ccdaf5080e44_report_name.csv",
  }
}
```