> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mangopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Echo reports

> List intents, intent actions, settlements and splits

{/* 
## Echo reports

Mangopay provides reports to allow you to download data related to Intents, Settlements and Splits in CSV format. You can generate these [via the API](/guides/echo/reports#generate-via-api) or <a href="https://hub.mangopay.com/" target="_blank">via the Dashboard</a> (which also handles automated scheduling).

There are 4 reports relevant to Echo, each with different available data columns and filters (see the reports guide for details):
- [Intent](/guides/echo/reports#intents) – Summary of all intents declared during the selected period, detailing the total funds expected to enter the platform’s escrow wallets.
- [Intent action](/guides/echo/reports#intent-actions) – Summary of all operations related to intents processed during the selected period, detailing the expected money movements to be escrowed — including payments, refunds, refund reversals, and chargebacks.
- [Settlement](/guides/echo/reports#settlements) – Summary of all settlement files uploaded during the selected period to initiate the reconciliation process, confirming the expected money movements to be escrowed.
- [Split](/guides/echo/reports#splits) – Summary of all splits related to intents during the selected period, detailing the transfer of funds to the declared destination.  */}

[Mangopay Echo](/guides/echo) provides 4 report types that give your platform full visibility on your declared intents, the payment lifecycle, reconciliation in settlements, and the subsequent splits to sellers.

You can access these reports <a href="https://hub.mangopay.com/" target="_blank">in the Dashboard</a> in ***Reports*** > ***Fees wallets*** tab. Contact your platform's Dashboard admin if you don't see the Reports feature in the side navigation.

In the Dashboard, as well as running reports manually, you can schedule reports to be generated automatically at regular intervals, such as daily, weekly, monthly, and quarterly.

## Types and columns

### Intents

<table>
  <tbody>
    <tr>
      <th class="header">Name</th>

      <td class="table-content">
        Echo Intent
      </td>
    </tr>

    <tr>
      <th class="header">Description</th>

      <td class="table-content">
        Summary of all intents declared during the selected period, detailing the total funds expected to enter the platform’s escrow wallets.
      </td>
    </tr>

    <tr>
      <th class="header">Data available from</th>

      <td class="table-content">
        January 1 of the previous calendar year (N-1)
      </td>
    </tr>

    <tr>
      <th class="header">Max date range</th>

      <td class="table-content">
        1 year
      </td>
    </tr>
  </tbody>
</table>

##### Columns

<table>
  <thead>
    <tr>
      <th class="header">Column</th>
      <th class="header">Description</th>
      <th class="header">Included by default</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td class="table-content">Id</td>
      <td class="table-content">Unique identifier of the intent</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">Status</td>
      <td class="table-content">Status of the intent</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">Amount</td>
      <td class="table-content">Amount of the debited funds in the currency of the debited amount</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">Currency</td>
      <td class="table-content">Currency of the debited amount</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">FeesAmount</td>
      <td class="table-content">Amount of the fees in the currency of the fees</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">FeesCurrency</td>
      <td class="table-content">Currency of the fees</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">Type</td>
      <td class="table-content">Type of the intent: PAYIN, REFUND, DISPUTE</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">PaymentMethod</td>
      <td class="table-content">Payment method of the intent</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">BuyerId</td>
      <td class="table-content">Unique identifier of the user at the source of the transaction</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">SellerId</td>
      <td class="table-content">Unique identifier of the user(s) at the destination of the transaction</td>
      <td class="table-content">Yes</td>
    </tr>
  </tbody>
</table>

### Intent actions

<table>
  <tbody>
    <tr>
      <th class="header">Name</th>

      <td class="table-content">
        Echo Intent Action
      </td>
    </tr>

    <tr>
      <th class="header">Description</th>

      <td class="table-content">
        Summary of all operations related to intents processed during the selected period, detailing the expected money movements to be escrowed — including payments, refunds (and reversals), and disputes.
      </td>
    </tr>

    <tr>
      <th class="header">Data available from</th>

      <td class="table-content">
        January 1 of the previous calendar year (N-1)
      </td>
    </tr>

    <tr>
      <th class="header">Max date range</th>

      <td class="table-content">
        1 year
      </td>
    </tr>
  </tbody>
</table>

##### Columns

<table>
  <thead>
    <tr>
      <th class="header">Column</th>
      <th class="header">Description</th>
      <th class="header">Included by default</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td class="table-content">IntentId</td>
      <td class="table-content">Unique identifier of the intent</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">Id</td>
      <td class="table-content">Unique identifier of the intent action (capture, refund, dispute, cancel)</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">ExternalProcessingDate</td>
      <td class="table-content">Unix timestamp of the date and time at which the intent was executed</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">ExternalProviderReference</td>
      <td class="table-content">Unique identifier of the intent in the external provider system</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">ExternalMerchantReference</td>
      <td class="table-content">Unique identifier of the intent in the merchant system</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">Status</td>
      <td class="table-content">Status of the intent action</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">Amount</td>
      <td class="table-content">Amount of the debited funds in the currency of the debited amount</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">Currency</td>
      <td class="table-content">Currency of the debited amount</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">FeesAmount</td>
      <td class="table-content">Amount of the fees in the currency of the fees</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">FeesCurrency</td>
      <td class="table-content">Currency of the fees</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">Type</td>
      <td class="table-content">Type of the intent: PAYIN, REFUND, DISPUTE</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">PaymentMethod</td>
      <td class="table-content">Payment method of the intent</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">BuyerId</td>
      <td class="table-content">Unique identifier of the user at the source of the transaction</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">SellerId</td>
      <td class="table-content">Unique identifier of the user(s) at the destination of the transaction</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr />
  </tbody>
</table>

### Settlements

<table>
  <tbody>
    <tr>
      <th class="header">Name</th>

      <td class="table-content">
        Echo Settlement
      </td>
    </tr>

    <tr>
      <th class="header">Description</th>

      <td class="table-content">
        Summary of all settlement files uploaded during the selected period to initiate the reconciliation process, confirming the expected money movements to be escrowed.
      </td>
    </tr>

    <tr>
      <th class="header">Data available from</th>

      <td class="table-content">
        January 1 of the previous calendar year (N-1)
      </td>
    </tr>

    <tr>
      <th class="header">Max date range</th>

      <td class="table-content">
        1 year
      </td>
    </tr>
  </tbody>
</table>

##### Columns

<table>
  <thead>
    <tr>
      <th class="header">Column</th>
      <th class="header">Description</th>
      <th class="header">Included by default</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td class="table-content">Id</td>
      <td class="table-content">Unique identifier of the settlement</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">CreationDate</td>
      <td class="table-content">Unix timestamp of the date and time at which the settlement was created</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">CreationDate:ISO</td>
      <td class="table-content">ISO format of the date and time at which the settlement was created</td>
      <td class="table-content">No</td>
    </tr>

    <tr>
      <td class="table-content">FileName</td>
      <td class="table-content">Name of settlement file</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">SettlementCurrency</td>
      <td class="table-content">Currency of the settlement</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">Status</td>
      <td class="table-content">Status of the settlement</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">SettledTransactionCount</td>
      <td class="table-content">Total number of intents that have been reconciled</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">UnsettledTransactionCount</td>
      <td class="table-content">Total number of intents that haven’t been reconciled</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">SettledAmount</td>
      <td class="table-content">Total amount of intents that have been reconciled</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">DeclaredAmount</td>
      <td class="table-content">Total amount of intents that have been declared</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">DeficitAmount</td>
      <td class="table-content">The difference between `DeclaredAmount` and \`SettledAmount</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr />
  </tbody>
</table>

### Splits

<table>
  <tbody>
    <tr>
      <th class="header">Name</th>

      <td class="table-content">
        Echo Splits
      </td>
    </tr>

    <tr>
      <th class="header">Description</th>

      <td class="table-content">
        Summary of all splits related to intents during the selected period, detailing the transfer of funds to the declared destination.
      </td>
    </tr>

    <tr>
      <th class="header">Data available from</th>

      <td class="table-content">
        January 1 of the previous calendar year (N-1)
      </td>
    </tr>

    <tr>
      <th class="header">Max date range</th>

      <td class="table-content">
        1 year
      </td>
    </tr>
  </tbody>
</table>

##### Columns

<table>
  <thead>
    <tr>
      <th class="header">Column</th>
      <th class="header">Description</th>
      <th class="header">Included by default</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td class="table-content">Id</td>
      <td class="table-content">Unique identifier of the split</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">IntentId</td>
      <td class="table-content">Unique identifier of the intent</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">AuthorId</td>
      <td class="table-content">Unique identifier of the user at the source of the split</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">Amount</td>
      <td class="table-content">Amount of the credited funds in the currency of the credited amount</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">Currency</td>
      <td class="table-content">Currency of the credited amount</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">FeesAmount</td>
      <td class="table-content">Amount of the fees in the currency of the fees</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">FeesCurrency</td>
      <td class="table-content">Currency of the fees</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">Status</td>
      <td class="table-content">Status of the split</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">Description</td>
      <td class="table-content">Description of the split</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">CreditedWalletId</td>
      <td class="table-content">Unique identifier of the credited wallet</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">DebitedWalletId</td>
      <td class="table-content">Unique identifier of the debited wallet</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">Scheduled</td>
      <td class="table-content">Whether or not `TransferDate` was sent in the intent or split</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">CreationDate</td>
      <td class="table-content">Unix timestamp of the date and time at which the split was created</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">CreationDate:ISO</td>
      <td class="table-content">ISO format of the date and time at which the split was created</td>
      <td class="table-content">No</td>
    </tr>

    <tr>
      <td class="table-content">ExecutionDate</td>
      <td class="table-content">Unix timestamp of the date and time at which the split was executed</td>
      <td class="table-content">Yes</td>
    </tr>

    <tr>
      <td class="table-content">ExecutionDate:ISO</td>
      <td class="table-content">ISO format of the date and time at which the split was executed</td>
      <td class="table-content">No</td>
    </tr>

    <tr />
  </tbody>
</table>

## Generate via API

<Steps>
  <Step title="Set up webhooks">
    The [API endpoint](/api-reference/reporting/report-object) for the Echo reports uses [webhooks](/webhooks) to notify your chosen URL that a report is ready for download.

    The time it takes for a report to be generated depends on the quantity of data. If exporting large amounts of data via API, ensure you have these webhook [event types](/webhooks/event-types) set up to know when to fetch the report:

    * `REPORT_GENERATED` – Indicates that a report is ready for download at the `DownloadURL`
    * `REPORT_FAILED` – Indicates that a report was not generated successfully
  </Step>

  <Step title="Define filters and columns">
    The available sub-parameters of the `Filters` parameter for the Echo reports depend on the type, which is defined in the `ReportType` field.

    <Tabs>
      <Tab title="Intents and actions">
        The `ECHO_INTENT` and `ECHO_INTENT_ACTION` reports have the same filters, which can be used in any combination.

        <Expandable title="properties" defaultOpen>
          <ParamField body="Type" type="string">
            The type of Intent (as indicated in the settlement file): `PAYIN`, `REFUND`, `DISPUTE`
          </ParamField>

          <ParamField body="Status" type="string">
            The `Status` of the Intent: `AUTHORIZED`, `PARTIALLY_CAPTURED`, `CAPTURED`, `CANCELED`, `REFUNDED`, `REFUND_REVERSED`, `DISPUTED`, `DEFENDED`, `DISPUTED_WON`, `DISPUTED_LOST`
          </ParamField>

          <ParamField body="PaymentMethod" type="string">
            The payment method of the Intent: one of the [supported values](/api-reference/echo/supported-payment-methods) of the `ExternalProviderPaymentMethod`
          </ParamField>
        </Expandable>
      </Tab>

      <Tab title="Settlements">
        On the `ECHO_SETTLEMENT` report, the following filters can be used (alone or together).

        <Expandable title="properties" defaultOpen>
          <ParamField body="Status" type="string">
            The `Status` of the Settlement: `UPLOADED`, `CREATED`, `UNMATCHED`, `PARTIALLY_MATCHED`, `PENDING_FUNDS_RECEPTION`, `INSUFFICIENT_FUNDS`, `RECONCILED`, `FAILED`
          </ParamField>

          <ParamField body="ExternalProviderName" type="string">
            The [supported third-party PSP](/api-reference/echo/supported-providers) processing the transaction.
          </ParamField>
        </Expandable>
      </Tab>

      <Tab title="Splits">
        On the `ECHO_SPLIT` report, the the following filters can be used (alone or in combination).

        <Expandable title="properties" defaultOpen>
          <ParamField body="Status" type="string">
            The `Status` of the Split: `CREATED`, `PENDING_FUNDS_RECEPTION`, `AVAILABLE`, `PENDING`, `COMPLETED`, `REJECTED`, `FAILED `, `REVERSED`
          </ParamField>

          <ParamField body="IntentId" type="string">
            The unique identifier of the related Intent.

            **Caution:** There is no validation that the `IntentId` is valid.
          </ParamField>

          <ParamField body="Scheduled" type="boolean">
            Whether or not the `TransferDate` was sent (in either the Intent or the Split), regardless of the `Status` of the Split.
          </ParamField>
        </Expandable>
      </Tab>
    </Tabs>

    All available columns are set by default on the Echo reports. You can customize this in the `Columns` parameter by sending the full list of columns you wish to see in the report.
  </Step>

  <Step title="Run the report">
    Run the report by calling the [POST Create a Report](/api-reference/reporting/create-report) endpoint and setting the relevant `ReportType`.

    Send your desired date period in the `AfterDate` and `BeforeDate` fields, which refer to the object `CreationDate` for Echo reports. Ensure that the difference between them is no more than 12 months and the `AfterDate` is not earlier than January 1 of the previous calendar year (N-1).

    Send your defined filters in the `Filters` parameter and, if not using the default columns, the full list of columns you wish to include in the `Columns` parameter.

    <CodeGroup>
      ```json ECHO_INTENT theme={null}
      {
          "Tag": "Created using the Mangopay API Postman collection",
          "DownloadFormat": "CSV",
          "ReportType": "ECHO_INTENT",
          "AfterDate": 1740787200,
          "BeforeDate": 1743544740,
          "Filters": {
              "PaymentMethod": "MASTERCARD",
              "Status": "CAPTURED",
              "Type": "PAYIN"
          }
      }
      ```

      ```json ECHO_INTENT_ACTION theme={null}
      {
          "Tag": "Created using the Mangopay API Postman collection",
          "DownloadFormat": "CSV",
          "ReportType": "ECHO_INTENT_ACTION",
          "AfterDate": 1740787200,
          "BeforeDate": 1743544740,
          "Filters": {
              "PaymentMethod": "MASTERCARD",
              "Status": "CAPTURED",
              "Type": "PAYIN"
          }
      }
      ```

      ```json ECHO_SETTLEMENT theme={null}
      {
          "Tag": "Created using the Mangopay API Postman collection",
          "DownloadFormat": "CSV",
          "ReportType": "ECHO_SETTLEMENT",
          "AfterDate": 1740787200,
          "BeforeDate": 1743544740,
          "Filters": {
              "Status": "RECONCILED",
              "ExternalProviderName": "STRIPE"
          }
      }
      ```

      ```json ECHO_SPLIT theme={null}
      {
          "Tag": "Created using the Mangopay API Postman collection",
          "DownloadFormat": "CSV",
          "ReportType": "ECHO_SPLIT",
          "AfterDate": 1740787200,
          "BeforeDate": 1743544740,
          "Filters" : {
              "Status" : "COMPLETED",
              "IntentId" : "int_0197f975-63f6-714e-8fc6-4451e128170f",
              "Scheduled" : false
          }
      }
      ```
    </CodeGroup>

    The API response shows the `Status` as `PENDING`, indicating that the report is being generated.

    <CodeGroup>
      ```json ECHO_INTENT expandable theme={null}
      {
          "Id": "report_01K21WBZNWF8JYD5NDMKA3YA73",
          "Tag": "Created using the Mangopay API Postman collection",
          "CreationDate": 1754557447,
          "ReportDate": null,
          "Status": "PENDING",
          "ResultCode": null,
          "ResultMessage": null,
          "DownloadFormat": "CSV",
          "DownloadURL": null,
          "ReportType": "ECHO_INTENT",
          "Sort": "CreationDate:DESC",
          "DateRangeBy": null,
          "AfterDate": 1740787200,
          "BeforeDate": 1743544740,
          "Filters": {
              "PaymentMethod": "MASTERCARD",
              "Status": "CAPTURED",
              "Type": "PAYIN"
          },
          "Columns": [
              {
                  "Name": "Id",
                  "IsDefault": true
              },
              {
                  "Name": "Status",
                  "IsDefault": true
              },
              {
                  "Name": "Amount",
                  "IsDefault": true
              },
              {
                  "Name": "Currency",
                  "IsDefault": true
              },
              {
                  "Name": "FeesAmount",
                  "IsDefault": true
              },
              {
                  "Name": "FeesCurrency",
                  "IsDefault": true
              },
              {
                  "Name": "Type",
                  "IsDefault": true
              },
              {
                  "Name": "PaymentMethod",
                  "IsDefault": true
              },
              {
                  "Name": "BuyerId",
                  "IsDefault": true
              },
              {
                  "Name": "SellerId",
                  "IsDefault": true
              }
          ]
      }
      ```

      ```json ECHO_INTENT_ACTION expandable theme={null}
      {
          "Id": "report_01K21XEH908CGAN6W8XJ1RK4GW",
          "Tag": "Created using the Mangopay API Postman collection",
          "CreationDate": 1754558580,
          "ReportDate": null,
          "Status": "PENDING",
          "ResultCode": null,
          "ResultMessage": null,
          "DownloadFormat": "CSV",
          "DownloadURL": null,
          "ReportType": "ECHO_INTENT_ACTION",
          "Sort": "CreationDate:DESC",
          "DateRangeBy": null,
          "AfterDate": 1740787200,
          "BeforeDate": 1743544740,
          "Filters": {
              "PaymentMethod": "MASTERCARD",
              "Status": "CAPTURED",
              "Type": "PAYIN"
          },
          "Columns": [
              {
                  "Name": "IntentId",
                  "IsDefault": true
              },
              {
                  "Name": "Id",
                  "IsDefault": true
              },
              {
                  "Name": "ExternalProcessingDate",
                  "IsDefault": true
              },
              {
                  "Name": "ExternalProviderReference",
                  "IsDefault": true
              },
              {
                  "Name": "ExternalMerchantReference",
                  "IsDefault": true
              },
              {
                  "Name": "Status",
                  "IsDefault": true
              },
              {
                  "Name": "Amount",
                  "IsDefault": true
              },
              {
                  "Name": "Currency",
                  "IsDefault": true
              },
              {
                  "Name": "FeesAmount",
                  "IsDefault": true
              },
              {
                  "Name": "FeesCurrency",
                  "IsDefault": true
              },
              {
                  "Name": "Type",
                  "IsDefault": true
              },
              {
                  "Name": "PaymentMethod",
                  "IsDefault": true
              },
              {
                  "Name": "BuyerId",
                  "IsDefault": true
              },
              {
                  "Name": "SellerId",
                  "IsDefault": true
              }
          ]
      }
      ```

      ```json ECHO_SETTLEMENT expandable theme={null}
      {
          "Id": "report_01K2208G3778ETC7KKF8AE2895",
          "Tag": "Created using the Mangopay API Postman collection",
          "CreationDate": 1754561527,
          "ReportDate": null,
          "Status": "PENDING",
          "ResultCode": null,
          "ResultMessage": null,
          "DownloadFormat": "CSV",
          "DownloadURL": null,
          "ReportType": "ECHO_SETTLEMENT",
          "Sort": "CreationDate:DESC",
          "DateRangeBy": null,
          "AfterDate": 1740787200,
          "BeforeDate": 1743544740,
          "Filters": {
              "Status": "RECONCILED",
              "ExternalProviderName": "STRIPE"
          },
          "Columns": [
              {
                  "Name": "Id",
                  "IsDefault": true
              },
              {
                  "Name": "CreationDate",
                  "IsDefault": true
              },
              {
                  "Name": "FileName",
                  "IsDefault": true
              },
              {
                  "Name": "SettlementCurrency",
                  "IsDefault": true
              },
              {
                  "Name": "Status",
                  "IsDefault": true
              },
              {
                  "Name": "SettledTransactionCount",
                  "IsDefault": true
              },
              {
                  "Name": "UnsettledTransactionCount",
                  "IsDefault": true
              },
              {
                  "Name": "SettledAmount",
                  "IsDefault": true
              },
              {
                  "Name": "DeclaredAmount",
                  "IsDefault": true
              },
              {
                  "Name": "DeficitAmount",
                  "IsDefault": true
              },
              {
                  "Name": "ExternalProviderName",
                  "IsDefault": true
              }
          ]
      }
      ```

      ```json ECHO_SPLIT expandable theme={null}
      {
          "Id": "report_01K220F5CEBWE4J9V25V7XNZX6",
          "Tag": "Created using the Mangopay API Postman collection",
          "CreationDate": 1754561746,
          "ReportDate": null,
          "Status": "PENDING",
          "ResultCode": null,
          "ResultMessage": null,
          "DownloadFormat": "CSV",
          "DownloadURL": null,
          "ReportType": "ECHO_SPLIT",
          "Sort": "CreationDate:DESC",
          "DateRangeBy": null,
          "AfterDate": 1740787200,
          "BeforeDate": 1743544740,
          "Filters": {
              "Status": "COMPLETED",
              "IntentId": "int_0197f975-63f6-714e-8fc6-4451e128170f",
              "Scheduled": false
          },
          "Columns": [
              {
                  "Name": "Id",
                  "IsDefault": true
              },
              {
                  "Name": "IntentId",
                  "IsDefault": true
              },
              {
                  "Name": "AuthorId",
                  "IsDefault": true
              },
              {
                  "Name": "Amount",
                  "IsDefault": true
              },
              {
                  "Name": "Currency",
                  "IsDefault": true
              },
              {
                  "Name": "FeesAmount",
                  "IsDefault": true
              },
              {
                  "Name": "FeesCurrency",
                  "IsDefault": true
              },
              {
                  "Name": "Status",
                  "IsDefault": true
              },
              {
                  "Name": "Description",
                  "IsDefault": true
              },
              {
                  "Name": "CreditedWalletId",
                  "IsDefault": true
              },
              {
                  "Name": "DebitedWalletId",
                  "IsDefault": true
              },
              {
                  "Name": "Scheduled",
                  "IsDefault": true
              },
              {
                  "Name": "CreationDate",
                  "IsDefault": true
              },
              {
                  "Name": "ExecutionDate",
                  "IsDefault": true
              }
          ]
      }
      ```
    </CodeGroup>
  </Step>

  <Step title="Download when ready">
    The report is ready for download when its status changes from `PENDING` to `GENERATED`, which triggers the  `REPORT_GENERATED` webhook.

    Call the [GET View a Report](/api-reference/reporting/view-report) endpoint to retrieve the `DownloadURL` value where you can download the report.

    If the `Status` changes to `FAILED`, triggering the `REPORT_FAILED` webhook, then more information about why the report could not be generated is available in the `ResultCode` and `ResultMessage`.
  </Step>

  <Step title="Repeat process as needed">
    All Echo reports are valid for 31 days. After this, the `Status` changes to `EXPIRED` at it is no longer available for download.

    You can re-generate another report with the same parameters and update the date range for the latest period.
  </Step>
</Steps>