---
title: "Get platform reports"
description: "Learn how to generate and download reports for your balance platform automatically or manually."
url: "https://docs.adyen.com/payouts/payout-service/prepare-reports/generate-download-reports"
source_url: "https://docs.adyen.com/payouts/payout-service/prepare-reports/generate-download-reports.md"
canonical: "https://docs.adyen.com/payouts/payout-service/prepare-reports/generate-download-reports"
last_modified: "2026-06-01T15:33:15+02:00"
language: "en"
---

# Get platform reports

Learn how to generate and download reports for your balance platform automatically or manually.

[View source](/payouts/payout-service/prepare-reports/generate-download-reports.md)

You can generate balance platform reports automatically according to a specific schedule, or manually on-demand.

## Requirements

| Requirement                                                               | Description                                                                                                                                                              |
| ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **[API credential roles](/development-resources/api-credentials/roles/)** | To [Download reports](#download) make sure that you have the following role:- **Report service user** API key with the **BalancePlatform Report Download role**          |
| **[Customer Area roles](/account/user-roles)**                            | Make sure that you have the following roles:- **Download Balance Platform reports**
- **Generate Balance Platform reports**                                              |
| **[Webhooks](/development-resources/webhooks)**                           | Subscribe to the following webhook(s):- [balancePlatform.report.created](https://docs.adyen.com/api-explorer/report-webhooks/latest/post/balancePlatform.report.created) |

## Generate reports

### Tab: Automatically

To automatically generate reports:

1. Log in to your [Customer Area](https://ca-test.adyen.com/) and make sure you are on the correct merchant account.

2. Go to **Reports**.

3. Select the name of the report you want to generate.

4. Select **Manage report**.

5. Select **Automatic (schedule based)**.

   Keep the **Automatic generation** toggle selected. If you deselect this option, the schedule for generating reports is deleted.

6. Select **Close**.

The schedule depends on the report type and your balance platform configuration. When a report is generated, Adyen sends a [balancePlatform.report.created](https://docs.adyen.com/api-explorer/report-webhooks/latest/post/balancePlatform.report.created) webhook.

### Tab: Manually

You can manually generate reports anytime in the [Customer Area](https://ca-test.adyen.com/). Some reports have additional options, such as generating in bulk, selecting a date range, or filtering.

1. Log in to your [Customer Area](https://ca-test.adyen.com/) and make sure you are on the correct merchant account.

2. Go to **Reports**.

3. Select the name of the report that you want to generate.

4. Select **Manage report**.

5. Select **Manual (generate once)**.

6. (Optional) Depending on the report type, select:

   1. **Bulk** to generate multiple reports.
   2. The date or time period that the report should cover.
   3. The balance account and/or account holder to filter the report on.
   4. The time zone that you want to base the report on.

7. Select **Generate report**.

Generating a report can take up to a few minutes.

## Get updates when a report is available

To get updates when a balance platform report is generated and available for download, listen to the [balancePlatform.report.created](https://docs.adyen.com/api-explorer/report-webhooks/latest/post/balancePlatform.report.created) webhook. The webhook contains the URL at which you can download the report.

**Example webhook**

```json
{
  "data": {
    "balancePlatform": "YourBalancePlatform",
    "creationDate": "2022-01-02T02:01:08+02:00",
    "id": "balanceplatform_balance_report_2022_01_01.csv",
    "downloadUrl": "https://balanceplatform-test.adyen.com/balanceplatform/reportDownload/v1/YourBalancePLatform/balanceplatform_balance_report_2022_01_01.csv",
    "reportType": "balanceplatform_balance_report",
    "fileName": "balanceplatform_balance_report_2022_01_01.csv"
  },
  "environment": "test",
  "type": "balancePlatform.report.created"
}
```

## Download reports

All reports are generated in CSV format. You can also generate the Accounting report in TSV format. We recommend that you create a script to load the reports and reconcile into your systems. Alternatively, you can use any spreadsheet software to open the file and reconcile manually.

You can download reports manually from your [Customer Area](https://ca-test.adyen.com/), or programmatically by making an HTTP GET request.

### Tab: Customer Area

You can download all generated balance platform reports from the **Reports** page of your [Customer Area](https://ca-test.adyen.com/).

To download reports manually:

1. Log in to your [Customer Area](https://ca-test.adyen.com/) and make sure you are on the correct merchant account.
2. Go to **Reports**.
3. Select the name of the report type you want to download.
4. In the **Generated reports** table, select the arrow in the **Download** column of the specific report you want to download.

### Tab: HTTP GET request

To download reports programmatically:

1. Ask your Adyen contact for your report credentials. You must use your report credentials to authenticate your GET request.

2. Download the report with an HTTP GET request. Include:

   * The name of your report.
   * Your API key or the basic authentication password for your report.
   * The URL from the `downloadUrl` field in the [balancePlatform.report.created](https://docs.adyen.com/api-explorer/report-webhooks/latest/post/balancePlatform.report.created) webhook.

The following is an example of how to use basic authentication to download a Balance Platform Balance Report:

**Download a Balance Report with basic authentication**

```bash
$ wget --http-user='report_[123456]@BalancePlatform.YOUR_BALANCE_PLATFORM' \
--http-password='YOUR_PASSWORD' \
https:\/\/balanceplatform-test.adyen.com\/balanceplatform\/reportDownload\/v1\/YOUR_BALANCE_PLATFORM\/balanceplatform_balance_report_2022_01_31.csv
```

The following is an example of how to use an API key to download a Balance Platform Balance Report:

**Download a Balance Report with API key**

```bash
curl -L -X GET 'https://balanceplatform-test.adyen.com/balanceplatform/reportDownload/v1/{YOUR_BALANCE_PLATFORM}/balanceplatform_balance_report_2022_01_31.csv' \
-H 'x-api-key: YOUR_API_KEY' \
```
