Overview
User management
- Users
- The Natural User object (SCA)
- POSTCreate a Natural User (SCA)
- PUTUpdate a Natural User (SCA)
- PUTCategorize a Natural User
- The Legal User object (SCA)
- POSTCreate a Legal User (SCA)
- PUTUpdate a Legal User (SCA)
- PUTCategorize a Legal User
- POSTEnroll a User in SCA
- GETView a User (SCA)
- GETList all Users
- Non-SCA endpoints
- User regulatory status
- User e-money
User verification
- 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
- 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
- Bank accounts
- Payouts
FX conversions
- Conversion rates
- Quotes
- Conversions
Transactions
- Transactions
Helpers
- API responses
- Country authorizations
- Webhooks
- Events
- Reports
Platform account
- Client
- Dashboard permissions
List all Users
List User objects and key details
// GET has no body parameters
[
{
"Id": "158026537",
"Tag": "Created using MANGOPAY API Collection Postman",
"CreationDate": 1670863988,
"PersonType": "LEGAL",
"Email": "richard.moulin@email.com",
"KYCLevel": "LIGHT",
"TermsAndConditionsAccepted": false,
"TermsAndConditionsAcceptedDate": null,
"UserCategory": "PAYER",
"UserStatus": "ACTIVE"
},
{
"Id": "158025445",
"Tag": "Created using MANGOPAY API Collection Postman",
"CreationDate": 1670862022,
"PersonType": "NATURAL",
"Email": "email@test.com",
"KYCLevel": "LIGHT",
"TermsAndConditionsAccepted": true,
"TermsAndConditionsAcceptedDate": 1670862022,
"UserCategory": "OWNER",
"UserStatus": "ACTIVE"
},
{
"Id": "158026721",
"Tag": "Created using MANGOPAY API Collection Postman",
"CreationDate": 1670864174,
"PersonType": "LEGAL",
"Email": "cortney_douglas@yahoo.com",
"KYCLevel": "REGULAR",
"TermsAndConditionsAccepted": true,
"TermsAndConditionsAcceptedDate": 1670864174,
"UserCategory": "OWNER",
"UserStatus": "ACTIVE"
}
]
This endpoint returns key information for each user created by the platform.
Query parameters
Start value: 1
Default value: 1
Indicates the index of the page for the pagination.
Max. value: 100
Default value: 10
Indicates the number of items returned for each page of the pagination.
Allowed values: CreationDate:ASC
, CreationDate:DESC
Indicates the direction in which to sort the list.
Responses
The list of users created by the platform.
The key information on the user created by the platform.
The unique identifier of the object.
Max. length: 255 characters
Custom data that you can add to this object.
The date and time at which the object was created.
Returned values: NATURAL, LEGAL
The type of the user:
NATURAL
– Natural users are individuals (natural persons).LEGAL
– Legal users are legal entities (legal persons) like companies, non-profits, and sole proprietors.
The PersonType
is defined by the endpoint used to create the user and can’t be modified.
Format: A valid email address
The email address of the user.
Default value: LIGHT
Returned values: LIGHT
, REGULAR
The verification status of the user set by Mangopay:
LIGHT
– Unverified, assigned by default to all users.REGULAR
– Verified, meaning the user has successfully completed the verification process and had the necessary documents validated by Mangopay. Only users whoseUserCategory
isOWNER
can submit verification documents for validation. Only users whoseKYCLevel
isREGULAR
can request payouts.
Whether the user has accepted Mangopay’s terms and conditions (as defined by your contract, see the T&Cs guide for details).
Must be true
if UserCategory
is OWNER
.
The date and time at which the TermsAndConditionsAccepted
value was set to true
.
Returned null
if UserCategory
is PAYER
.
Returned values: PAYER
, OWNER
, PLATFORM
The category of the user:
PAYER
– User who can only make pay-ins to their wallets and transfers to other wallets.OWNER
– User who can also receive transfers to their wallets. Owners are able to request KYC verification, which if successful gives them theKYCLevel
ofREGULAR
and the ability to request payouts.PLATFORM
– Value assigned only by Mangopay.
Returned values: ACTIVE, CLOSED
Internal use only. This field can only be used and updated by Mangopay teams.
[
{
"Id": "158026537",
"Tag": "Created using MANGOPAY API Collection Postman",
"CreationDate": 1670863988,
"PersonType": "LEGAL",
"Email": "richard.moulin@email.com",
"KYCLevel": "LIGHT",
"TermsAndConditionsAccepted": false,
"TermsAndConditionsAcceptedDate": null,
"UserCategory": "PAYER",
"UserStatus": "ACTIVE"
},
{
"Id": "158025445",
"Tag": "Created using MANGOPAY API Collection Postman",
"CreationDate": 1670862022,
"PersonType": "NATURAL",
"Email": "email@test.com",
"KYCLevel": "LIGHT",
"TermsAndConditionsAccepted": true,
"TermsAndConditionsAcceptedDate": 1670862022,
"UserCategory": "OWNER",
"UserStatus": "ACTIVE"
},
{
"Id": "158026721",
"Tag": "Created using MANGOPAY API Collection Postman",
"CreationDate": 1670864174,
"PersonType": "LEGAL",
"Email": "cortney_douglas@yahoo.com",
"KYCLevel": "REGULAR",
"TermsAndConditionsAccepted": true,
"TermsAndConditionsAcceptedDate": 1670864174,
"UserCategory": "OWNER",
"UserStatus": "ACTIVE"
}
]
// GET has no body parameters
Was this page helpful?
// GET has no body parameters
[
{
"Id": "158026537",
"Tag": "Created using MANGOPAY API Collection Postman",
"CreationDate": 1670863988,
"PersonType": "LEGAL",
"Email": "richard.moulin@email.com",
"KYCLevel": "LIGHT",
"TermsAndConditionsAccepted": false,
"TermsAndConditionsAcceptedDate": null,
"UserCategory": "PAYER",
"UserStatus": "ACTIVE"
},
{
"Id": "158025445",
"Tag": "Created using MANGOPAY API Collection Postman",
"CreationDate": 1670862022,
"PersonType": "NATURAL",
"Email": "email@test.com",
"KYCLevel": "LIGHT",
"TermsAndConditionsAccepted": true,
"TermsAndConditionsAcceptedDate": 1670862022,
"UserCategory": "OWNER",
"UserStatus": "ACTIVE"
},
{
"Id": "158026721",
"Tag": "Created using MANGOPAY API Collection Postman",
"CreationDate": 1670864174,
"PersonType": "LEGAL",
"Email": "cortney_douglas@yahoo.com",
"KYCLevel": "REGULAR",
"TermsAndConditionsAccepted": true,
"TermsAndConditionsAcceptedDate": 1670864174,
"UserCategory": "OWNER",
"UserStatus": "ACTIVE"
}
]