POST
/
v2.01
/
{ClientId}
/
reporting
/
reports
{
    "Tag": "Created using the Mangopay API Postman collection",
    "DownloadFormat": "CSV",
    "ReportType": "USER_WALLET_TRANSACTIONS",
    "AfterDate": 1740787200,
    "BeforeDate": 1743465599,
    "Filters": {
        "UserId": "user_m_01JSM1ZG3MAWR272S99ZKE2WSP",
        "Currency": "EUR"
    }
}

{
    "Id": "report_01JVVQFJETHHP9M9S18RN6N8JZ",
    "Tag": "Created using the Mangopay API Postman collection",
    "CreationDate": 1747908544,
    "ReportDate": null,
    "Status": "PENDING",
    "ResultCode": null,
    "ResultMessage": null,
    "DownloadFormat": "CSV",
    "DownloadURL": null,
    "ReportType": "USER_WALLET_TRANSACTIONS",
    "Sort": "CreationDate:DESC",
    "AfterDate": 1740787200,
    "BeforeDate": 1743465599,
    "Filters": {
        "UserId": "user_m_01JSM1ZG3MAWR272S99ZKE2WSP",
        "Currency": "EUR"
    },
    "Columns": [
        {
            "Name": "ClientId",
            "IsDefault": true
        },
        {
            "Name": "TransactionId",
            "IsDefault": true
        },
        {
            "Name": "CreationDate",
            "IsDefault": true
        },
        {
            "Name": "ExecutionDate",
            "IsDefault": true
        },
        {
            "Name": "AuthorId",
            "IsDefault": true
        },
        {
            "Name": "CreditedUserId",
            "IsDefault": true
        },
        {
            "Name": "DebitedFundsAmount",
            "IsDefault": true
        },
        {
            "Name": "DebitedFundsCurrency",
            "IsDefault": true
        },
        {
            "Name": "CreditedFundsAmount",
            "IsDefault": true
        },
        {
            "Name": "CreditedFundsCurrency",
            "IsDefault": true
        },
        {
            "Name": "FeesAmount",
            "IsDefault": true
        },
        {
            "Name": "FeesCurrency",
            "IsDefault": true
        },
        {
            "Name": "Type",
            "IsDefault": true
        },
        {
            "Name": "Nature",
            "IsDefault": true
        },
        {
            "Name": "CreditedWalletId",
            "IsDefault": true
        },
        {
            "Name": "DebitedWalletId",
            "IsDefault": true
        },
        {
            "Name": "BankAccountId",
            "IsDefault": true
        },
        {
            "Name": "PreauthorizationId",
            "IsDefault": true
        },
        {
            "Name": "BankWireRef",
            "IsDefault": true
        },
        {
            "Name": "CardId",
            "IsDefault": true
        },
        {
            "Name": "CardAlias",
            "IsDefault": true
        },
        {
            "Name": "CardType",
            "IsDefault": true
        },
        {
            "Name": "CardCountry",
            "IsDefault": true
        },
        {
            "Name": "CardExpirationDate",
            "IsDefault": true
        },
        {
            "Name": "Culture",
            "IsDefault": true
        },
        {
            "Name": "DeclaredDebitedFundsAmount",
            "IsDefault": true
        },
        {
            "Name": "DeclaredDebitedFundsCurrency",
            "IsDefault": true
        },
        {
            "Name": "DeclaredFeesAmount",
            "IsDefault": true
        },
        {
            "Name": "DeclaredFeesCurrency",
            "IsDefault": true
        },
        {
            "Name": "ExecutionType",
            "IsDefault": true
        },
        {
            "Name": "PaymentType",
            "IsDefault": true
        },
        {
            "Name": "WireReference",
            "IsDefault": true
        }
    ]
}
This endpoint generates a report from Mangopay’s Reporting Service, which is replacing the legacy report types (read the guide). There are 2 reports (indicated by ReportType) that may be useful to all platforms: USER_WALLET_TRANSACTIONS and COLLECTED_FEES. There are 4 ReportType that are designed to support platforms using Echo, Mangopay solution for integrations working with third-party PSPs: ECHO_INTENT, ECHO_INTENT_ACTION, ECHO_SETTLEMENT, ECHO_SPLIT. Each ReportType has different available Columns and Filters.
Note – Report expires after 31 daysA Reporting Service report expires after 31 days, at which point it can no longer be downloaded. On expiry, the report’s Status becomes EXPIRED and the DownloadURL becomes null.You can generate a new report with the same filters and dates.

​
Body parameters

​
Tag
string
Max. length: 255 charactersCustom data that you can add to this object.For reports, this parameter can be useful to give the report a name.
​
DownloadFormat
string
required
Possible values: CSVThe format of the report file.
​
ReportType
string
required
Possible values: COLLECTED_FEES, USER_WALLET_TRANSACTIONS, ECHO_INTENT, ECHO_INTENT_ACTION, ECHO_SETTLEMENT, ECHO_SPLIT.The type of the report. Each ReportType has different available Columns and Filters.Useful for all platforms:
  • USER_WALLET_TRANSACTIONS – All transactions crediting or debiting user wallets: pay-ins, transfers, conversions, and payouts, as well as refunds of all types and repudiations (from chargebacks).
  • COLLECTED_FEES– Detail of transactions crediting or debiting the fees wallet: transactions of all types (pay-ins, transfers, refunds, payouts, etc.) that have a positive or negative fees amount.
Useful for platforms using Echo, Mangopay’s solution for integrations working with third-party PSPs:
  • ECHO_INTENT – Summary of all intents declared during the selected period, detailing the total funds expected to enter the platform’s escrow wallets.
  • ECHO_INTENT_ACTION – 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.
  • ECHO_SETTLEMENT – Summary of all settlement files uploaded during the selected period to initiate the reconciliation process, confirming the expected money movements to be escrowed.
  • ECHO_SPLIT – Summary of all splits related to intents during the selected period, detailing the transfer of funds to the declared destination.
​
Sort
string
Possible values: CreationDate:ASC, CreationDate:DESCDefault value: CreationDate:DESCThe sort direction based on transaction creation date.
​
AfterDate
Unix timestamp
required
Possible values: Any past date and time up 24 months ago that is earlier than the BeforeDate by less than 12 monthsThe date and time after which the report’s transaction was created, based on the transaction’s CreationDate.
​
BeforeDate
Unix timestamp
required
Possible values: Any past date and time up 24 months ago that is later than the AfterDate by less than 12 monthsThe date and time before which the report’s transaction was created, based on the transaction’s CreationDate.
​
Filters
object
The filers to apply. Each ReportType has different available filters:
The Currency filter is available. If not specified, the report contains data on all currencies.
​
Columns
array
Possible values: The columns listed in the Reports guide, which differ according to the report type.Default values: The default columns listed in the Reports guide, which differ according to the report type.The data columns to be included in the report.

​
Responses

{
    "Id": "report_01JVVQFJETHHP9M9S18RN6N8JZ",
    "Tag": "Created using the Mangopay API Postman collection",
    "CreationDate": 1747908544,
    "ReportDate": null,
    "Status": "PENDING",
    "ResultCode": null,
    "ResultMessage": null,
    "DownloadFormat": "CSV",
    "DownloadURL": null,
    "ReportType": "USER_WALLET_TRANSACTIONS",
    "Sort": "CreationDate:DESC",
    "AfterDate": 1740787200,
    "BeforeDate": 1743465599,
    "Filters": {
        "UserId": "user_m_01JSM1ZG3MAWR272S99ZKE2WSP",
        "Currency": "EUR"
    },
    "Columns": [
        {
            "Name": "ClientId",
            "IsDefault": true
        },
        {
            "Name": "TransactionId",
            "IsDefault": true
        },
        {
            "Name": "CreationDate",
            "IsDefault": true
        },
        {
            "Name": "ExecutionDate",
            "IsDefault": true
        },
        {
            "Name": "AuthorId",
            "IsDefault": true
        },
        {
            "Name": "CreditedUserId",
            "IsDefault": true
        },
        {
            "Name": "DebitedFundsAmount",
            "IsDefault": true
        },
        {
            "Name": "DebitedFundsCurrency",
            "IsDefault": true
        },
        {
            "Name": "CreditedFundsAmount",
            "IsDefault": true
        },
        {
            "Name": "CreditedFundsCurrency",
            "IsDefault": true
        },
        {
            "Name": "FeesAmount",
            "IsDefault": true
        },
        {
            "Name": "FeesCurrency",
            "IsDefault": true
        },
        {
            "Name": "Type",
            "IsDefault": true
        },
        {
            "Name": "Nature",
            "IsDefault": true
        },
        {
            "Name": "CreditedWalletId",
            "IsDefault": true
        },
        {
            "Name": "DebitedWalletId",
            "IsDefault": true
        },
        {
            "Name": "BankAccountId",
            "IsDefault": true
        },
        {
            "Name": "PreauthorizationId",
            "IsDefault": true
        },
        {
            "Name": "BankWireRef",
            "IsDefault": true
        },
        {
            "Name": "CardId",
            "IsDefault": true
        },
        {
            "Name": "CardAlias",
            "IsDefault": true
        },
        {
            "Name": "CardType",
            "IsDefault": true
        },
        {
            "Name": "CardCountry",
            "IsDefault": true
        },
        {
            "Name": "CardExpirationDate",
            "IsDefault": true
        },
        {
            "Name": "Culture",
            "IsDefault": true
        },
        {
            "Name": "DeclaredDebitedFundsAmount",
            "IsDefault": true
        },
        {
            "Name": "DeclaredDebitedFundsCurrency",
            "IsDefault": true
        },
        {
            "Name": "DeclaredFeesAmount",
            "IsDefault": true
        },
        {
            "Name": "DeclaredFeesCurrency",
            "IsDefault": true
        },
        {
            "Name": "ExecutionType",
            "IsDefault": true
        },
        {
            "Name": "PaymentType",
            "IsDefault": true
        },
        {
            "Name": "WireReference",
            "IsDefault": true
        }
    ]
}

{
    "Tag": "Created using the Mangopay API Postman collection",
    "DownloadFormat": "CSV",
    "ReportType": "USER_WALLET_TRANSACTIONS",
    "AfterDate": 1740787200,
    "BeforeDate": 1743465599,
    "Filters": {
        "UserId": "user_m_01JSM1ZG3MAWR272S99ZKE2WSP",
        "Currency": "EUR"
    }
}