Overview
User management
- Users
- User regulatory status
- User e-money
User verification
- IDV sessions
- User data format
- KYC documents
- UBO declarations
Wallets
- User wallets
- Client wallets
Cards
- Card registrations
- Cards
- Metadata
- Card validations
Card pay-ins
- Direct card pay-ins
- Recurring card pay-ins
- Preauthorizations
- Deposit preauthorizations
- Web card pay-ins
Banking pay-ins
- Bank wires
- Pay by bank
- Virtual IBAN
- Direct debits
- Web direct debits
APM pay-ins
- Apple Pay
- Bancontact
- BLIK
- Giropay
- Google Pay
- iDEAL
- Klarna
- MB WAY
- Multibanco
- Payconiq
- PayPal
- Satispay
- Swish
- TWINT
Transfers
- Transfers
Refunds
- Refunds
Disputes
- Disputes
- Dispute documents
- Repudiations
- Dispute settlement
Payouts
- Recipients
- Bank accounts
- Payouts
FX conversions
- Conversion rates
- Quotes
- Conversions
Transactions
- Transactions
Helpers
- API responses
- Country authorizations
- Webhooks
- Events
- Reports
Platform account
- Client
- Dashboard permissions
View a Report
Retrieve a report from the Reporting Service
// GET has no body parameters
{
"Id": "report_01JVVQFJETHHP9M9S18RN6N8JZ",
"Tag": "Created using the Mangopay API Postman collection",
"CreationDate": 1747908544,
"ReportDate": 1747908545,
"Status": "GENERATED",
"ResultCode": "000000",
"ResultMessage": "Success",
"DownloadFormat": "CSV",
"DownloadURL": "https://reporting-sandbox-downloads.mangopay.com/reporting/user-wallet-transactions-b87d078d-ec6a-41aa-8719-4dc86f341e60-user-id-user_m_01JSM1ZG3MAWR272S99ZKE2WSP-wallet-id-wlt_m_01JSM21JYR8CFM43XREZQS1ZXH.csv?Policy=eyJTdGF0ZW1lbnQiOiBbeyJSZXNvdXJjZSI6IioiLCJDb25kaXRpb24iOnsiRGF0ZUxlc3NUaGFuIjp7IkFXUzpFcG9jaFRpbWUiOjE3NTA1NTA0MDB9fX1dfQ__&Signature=TkzN3liwlGu4kLWNWZ2-FRWzwvzYNK2jQAgOmm6MBSl6qiSYOamgGGy~aNCTOWM8sBDgVCveau7W9rqxNajXsJKoVfJbNZYNyDnJlYZt24KMiq0SeBIQ0nLTukr1q-eYOpB7cjVikGetikKNldNUeDYdB3-dqIHUecNpBvRkw9Zoa72cfheznwsrA3XwuHcWpwHdcFHXpz89OD10Fbr75mRKrIqmzb5ecGFRXDjmtBl3UD~iFXyPusDV8UiBAuM6bRinHTenq9Mff4j1~MgTjmSnG7ZSwKsxHG50CJ-G5hhiWtAPgptbwck~2C7Lv7L1Hk1h7u59ZPI0IOh8cXMSKA__&Key-Pair-Id=K16WIKTSLTS2C2",
"ReportType": "USER_WALLET_TRANSACTIONS",
"Sort": "CreationDate:DESC",
"AfterDate": 1740787200,
"BeforeDate": 1743465599,
"Filters": {
"UserId": "user_m_01JSM1ZG3MAWR272S99ZKE2WSP",
"WalletId": "wlt_m_01JSM21JYR8CFM43XREZQS1ZXH"
},
"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
}
]
}
Path parameters
The unique identifier of the Reporting Service report.
Responses
Max length: 128 characters (see data formats for details)
The unique identifier of the object.
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.
The date and time at which the object was created.
The date and time at which the report was generated.
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).
The code indicating the result of the operation. This information is mostly used to handle errors or for filtering purposes.
The explanation of the result code.
Returned values: CSV
The format in which the report is going to be downloaded.
The URL at which the report file can be downloaded when the Status
is GENERATED
.
The type of the report:
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.
The sorting direction of the CreationDate column. By default, the generated report is sorted by ascending creation date.
Possible values: Any date and time (before the BeforeDate
) between the present and 24 months ago.
The date and time after which the report’s transaction was created, based on the transaction’s CreationDate
.
Note: The period between the AfterDate
and the BeforeDate
cannot exceed 12 months.
Possible values: Any date and time (after the AfterDate
) between the present and 24 months ago.
The date and time before which the report’s transaction was created, based on the transaction’s CreationDate
.
Note: The period between the AfterDate
and the BeforeDate
cannot exceed 12 months.
Possible values: Currency
, UserId
, WalletId
The filers to apply.
If the ReportType
is COLLECTED_FEES
, only the Currency
filter can be used. If the currency is not specified, the report contains data on all currencies.
If the ReportType
is USER_WALLET_TRANSACTIONS
, each filter can be used on its own or in combination, in which case the report data satisfies both filters.
UserId
andCurrency
– Report contains all transactions (credited or debited) in the currency where UserId is the AuthorIdUserId
andWalletId
– Report contains all transactions (credited or debited) in all currencies where the UserId is specified as theDebitedWalletId
orCreditedWalletId
. If theWalletId
is not a wallet owned by theUserId
, then the report will be empty.
The Currency
and WalletId
cannot be used together.
If no Filters
are specified, the report contains all transactions crediting or debiting all user wallets.
Caution: The WalletId
and UserId
values are not validated before the request is launched, so if both are used but don’t correspond (the user doesn’t own the wallet), then the report will be empty.
The currency of the DebitedFunds
, CreditedFunds
, or Fees
of the transactions.
The unique identifier of the user referenced as the AuthorId
or CreditedUserId
of the transaction.
The unique identifier of the wallet referenced as the DebitedWalletId
or CreditedWalletId
of the transaction.
{
"Id": "report_01JVVQFJETHHP9M9S18RN6N8JZ",
"Tag": "Created using the Mangopay API Postman collection",
"CreationDate": 1747908544,
"ReportDate": 1747908545,
"Status": "GENERATED",
"ResultCode": "000000",
"ResultMessage": "Success",
"DownloadFormat": "CSV",
"DownloadURL": "https://reporting-sandbox-downloads.mangopay.com/reporting/user-wallet-transactions-b87d078d-ec6a-41aa-8719-4dc86f341e60-user-id-user_m_01JSM1ZG3MAWR272S99ZKE2WSP-wallet-id-wlt_m_01JSM21JYR8CFM43XREZQS1ZXH.csv?Policy=eyJTdGF0ZW1lbnQiOiBbeyJSZXNvdXJjZSI6IioiLCJDb25kaXRpb24iOnsiRGF0ZUxlc3NUaGFuIjp7IkFXUzpFcG9jaFRpbWUiOjE3NTA1NTA0MDB9fX1dfQ__&Signature=TkzN3liwlGu4kLWNWZ2-FRWzwvzYNK2jQAgOmm6MBSl6qiSYOamgGGy~aNCTOWM8sBDgVCveau7W9rqxNajXsJKoVfJbNZYNyDnJlYZt24KMiq0SeBIQ0nLTukr1q-eYOpB7cjVikGetikKNldNUeDYdB3-dqIHUecNpBvRkw9Zoa72cfheznwsrA3XwuHcWpwHdcFHXpz89OD10Fbr75mRKrIqmzb5ecGFRXDjmtBl3UD~iFXyPusDV8UiBAuM6bRinHTenq9Mff4j1~MgTjmSnG7ZSwKsxHG50CJ-G5hhiWtAPgptbwck~2C7Lv7L1Hk1h7u59ZPI0IOh8cXMSKA__&Key-Pair-Id=K16WIKTSLTS2C2",
"ReportType": "USER_WALLET_TRANSACTIONS",
"Sort": "CreationDate:DESC",
"AfterDate": 1740787200,
"BeforeDate": 1743465599,
"Filters": {
"UserId": "user_m_01JSM1ZG3MAWR272S99ZKE2WSP",
"WalletId": "wlt_m_01JSM21JYR8CFM43XREZQS1ZXH"
},
"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
}
]
}
// GET has no body parameters
Was this page helpful?
// GET has no body parameters
{
"Id": "report_01JVVQFJETHHP9M9S18RN6N8JZ",
"Tag": "Created using the Mangopay API Postman collection",
"CreationDate": 1747908544,
"ReportDate": 1747908545,
"Status": "GENERATED",
"ResultCode": "000000",
"ResultMessage": "Success",
"DownloadFormat": "CSV",
"DownloadURL": "https://reporting-sandbox-downloads.mangopay.com/reporting/user-wallet-transactions-b87d078d-ec6a-41aa-8719-4dc86f341e60-user-id-user_m_01JSM1ZG3MAWR272S99ZKE2WSP-wallet-id-wlt_m_01JSM21JYR8CFM43XREZQS1ZXH.csv?Policy=eyJTdGF0ZW1lbnQiOiBbeyJSZXNvdXJjZSI6IioiLCJDb25kaXRpb24iOnsiRGF0ZUxlc3NUaGFuIjp7IkFXUzpFcG9jaFRpbWUiOjE3NTA1NTA0MDB9fX1dfQ__&Signature=TkzN3liwlGu4kLWNWZ2-FRWzwvzYNK2jQAgOmm6MBSl6qiSYOamgGGy~aNCTOWM8sBDgVCveau7W9rqxNajXsJKoVfJbNZYNyDnJlYZt24KMiq0SeBIQ0nLTukr1q-eYOpB7cjVikGetikKNldNUeDYdB3-dqIHUecNpBvRkw9Zoa72cfheznwsrA3XwuHcWpwHdcFHXpz89OD10Fbr75mRKrIqmzb5ecGFRXDjmtBl3UD~iFXyPusDV8UiBAuM6bRinHTenq9Mff4j1~MgTjmSnG7ZSwKsxHG50CJ-G5hhiWtAPgptbwck~2C7Lv7L1Hk1h7u59ZPI0IOh8cXMSKA__&Key-Pair-Id=K16WIKTSLTS2C2",
"ReportType": "USER_WALLET_TRANSACTIONS",
"Sort": "CreationDate:DESC",
"AfterDate": 1740787200,
"BeforeDate": 1743465599,
"Filters": {
"UserId": "user_m_01JSM1ZG3MAWR272S99ZKE2WSP",
"WalletId": "wlt_m_01JSM21JYR8CFM43XREZQS1ZXH"
},
"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
}
]
}