--- title: "List all Reports" method: GET path: "/v2.01/{ClientId}/reports" tags: ["Reports"] --- # List all Reports `GET /v2.01/{ClientId}/reports` List all legacy reports ## Path parameters - `ClientId` string, required ## Query parameters - `BeforeDate` integer - `AfterDate` integer ## Headers - `Authorization` string, required ## Response `200` Success - ListAllReportsResponseLegacy - `Array (Reports)` ListAllReportsResponseLegacyArrayReportsItems[] — The list of reports created by the platform. - `Object (Reports)` ListAllReportsResponseLegacyArrayReportsItemsObjectReports — The Report object created by the platform. - `Id` string — Max length: 128 characters (see [data formats](/api-reference/overview/data-formats) for details) The unique identifier of the object. - `CreationDate` integer — Unix timestamp (UTC) of the date and time the object was created. - `Tag` string — Max. length: 255 characters Custom data that you can add to this object. For reports, this parameter can be useful to give the report a name. - `ReportDate` integer, nullable — Unix timestamp (UTC) of the date and time the report was generated. - `Status` string — **Returned values:** `PENDING`, `READY_FOR_DOWNLOAD`, `FAILED`, `EXPIRED` The status of the report: - `PENDING` – The report is being generated. - `READY_FOR_DOWNLOAD` – The report has been created, and can be downloaded. - `FAILED` – The report cannot be generated. - `EXPIRED` – The report was created, but is no longer available for download (it can be re-run to be downloaded again with fresh data). - `DownloadFormat` string — **Returned values:** `CSV` The format in which the report is going to be downloaded. - `DownloadURL` string, nullable — The URL at which the report file can be downloaded when the `Status` is `GENERATED`. - `CallbackURL` string — Max. length: 255 characters The URL to which the notification indicating that the report is ready to be downloaded will be sent. - `ReportType` string — **Returned values:** `TRANSACTIONS`, `WALLETS` The type of the report, indicating whether it lists transactions or wallets. - `Sort` string — The sorting direction of the CreationDate column. By default, the generated report is sorted by ascending creation date. - `Preview` boolean — Whether the report is limited to the first 10 lines (and therefore quicker to generate). - `Filters` BeforeDateAfterDateType — The filtering parameters to optimize the report. - `BeforeDate` integer — **Returned values:** Any date between today's date and 36 months in the past. The date before which the transaction was created (based on the transaction's `CreationDate` parameter). **Caution:** The time range between the `BeforeDate` and the `AfterDate` cannot exceed 6 months. - `AfterDate` integer — The date after which the transaction was created (based on the transaction's `CreationDate` parameter). **Caution:** The time range between the `BeforeDate` and the `AfterDate` cannot exceed 6 months. - `Type` string[] — The transaction types to be taken into account. - `ResultCode` string[] — The transaction result codes to be taken into account. - `Status` string[] — The transaction statuses to be taken into account. - `Nature` string[] — **Returned values:** `REGULAR`, `REPUDIATION`, `REFUND`, `SETTLEMENT` The transaction natures to be taken into account. - `REGULAR` – Relative to most of the transactions (pay-ins, payouts, and transfers) in a usual workflow. - `REPUDIATION` – Automatic withdrawal of funds from the platform's repudiation wallet as part of the dispute process (when the user has requested a chargeback). - `REFUND` – Reimbursement of a transaction to the user (pay-in refund), to a wallet (transfer refund), or of a payout (payout refund, only initiated by Mangopay). - `SETTLEMENT` – Transfer made to the repudiation wallet by the platform to settle a lost dispute. - `WalletId` string — The unique identifier of the wallet that is to be taken into account. - `AuthorId` string — The unique identifier of the user at the source of the transaction. - `MinDebitedFundsAmount` integer — The debited funds amount above which the transactions are taken into account. - `MinDebitedFundsCurrency` string — **Returned values:** The three-letter ISO 4217 code (EUR, GBP, etc.) of a supported currency (depends on feature, contract, and activation settings). The currency of the `MinDebitedFundsAmount` value. - `MaxDebitedFundsAmount` integer — The debited funds amount below which the transactions are taken into account. - `MaxDebitedFundsCurrency` string — **Returned values:** The three-letter ISO 4217 code (EUR, GBP, etc.) of a supported currency (depends on feature, contract, and activation settings). The currency of the `MaxDebitedFundsAmount` value. - `MinFeesAmount` integer — The fees amount below which the transactions are taken into account. - `MinFeesCurrency` string — **Returned values:** The three-letter ISO 4217 code (EUR, GBP, etc.) of a supported currency (depends on feature, contract, and activation settings). The currency of the `MinFeesAmount` value. - `MaxFeesAmount` integer — The fees amount above which the transactions are taken into account. - `MaxFeesCurrency` string — **Returned values:** The three-letter ISO 4217 code (EUR, GBP, etc.) of a supported currency (depends on feature, contract, and activation settings). The currency of the `MaxFeesAmount` value. - `Columns` string[] — **Returned values:** The `Columns` listed in the Reports article, which differ according to the report type. The information to be included in the report. - `ResultCode` string — The code indicating the result of the operation. This information is mostly used to handle errors or for filtering purposes. - `ResultMessage` string — The explanation of the result code. --- [API](https://skmtc.dev/mangopay/apis/api-reference.md) · [All operations](https://skmtc.dev/mangopay/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mangopay/api-reference/revisions/fafbd0c69654/schema)