View Checks for an IDV Session
Overview
User management
- Users
- 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
- 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
- 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 Checks for an IDV Session
Obtain verified user data and results of each check performed
GET
/
v2.01
/
{ClientId}
/
identity-verifications
/
{IdvSessionId}
/
checks
Copy
// GET has no body parameters
Copy
{
"SessionId": "idnver_01JH2ZK1MKAMG5H2Q20M5K6020",
"Status": "VALIDATED",
"CreationDate": 1736340768,
"LastUpdate": 1736341038,
"Checks": [
{
"CheckId": "idnchc_01JH2ZQEX65TJ7NMANSPYB5JXR",
"Type": "BUSINESS_VERIFICATION",
"CheckStatus": "VALIDATED",
"CreationDate": 1736340913,
"LastUpdate": 1736340913,
"Data": [
{
"Type": "COMPANY_NAME",
"Value": "Top Consulting"
},
{
"Type": "COMPANY_NUMBER",
"Value": "123456789"
}
]
},
{
"CheckId": "idnchc_01JH2ZV6ZQDBT0VS1YKKPZC6GJ",
"Type": "IDENTITY_DOCUMENT_VERIFICATION",
"CheckStatus": "VALIDATED",
"CreationDate": 1736341036,
"LastUpdate": 1736341036,
"Data": [
{
"Type": "LEGAL_REPRESENTATIVE_FIRST_NAME",
"Value": "ALEX"
},
{
"Type": "LEGAL_REPRESENTATIVE_LAST_NAME",
"Value": "SMITH"
},
{
"Type": "LEGAL_REPRESENTATIVE_BIRTHDATE",
"Value": "665452800"
},
{
"Type": "LEGAL_REPRESENTATIVE_NATIONALITY",
"Value": "FR"
},
{
"Type": "LEGAL_REPRESENTATIVE_RESIDENCY",
"Value": "FR"
},
{
"Type": "DOCUMENT_TYPE",
"Value": "DRIVERS_LICENSE"
},
{
"Type": "DOCUMENT_NUMBER",
"Value": "12AB12345"
},
{
"Type": "DOCUMENT_EXPIRATION_DATE_UNIX",
"Value": "2046902400"
}
]
}
]
}
Path parameters
The unique identifier of the identity verification session.
Responses
Unique identifier for the entire verification session.
The status of the hosted identity verification session:
- VALIDATED – The session was successful.
- REJECTED – The session failed.
- EXPIRED_CREDENTIALS – The session is no longer valid (likely due to expired documents used during the session).
- TIMEOUT – The session timed out due to inactivity.
- PENDING – The session is in progress and user action is required to complete it.
- REVIEW – The session is under manual review by Mangopay.
- ERROR – The session was not completed because an error occurred.
The date and time at which the session was created.
The date and time at which the session was last updated.
The details of the individual verification checks performed during the session.
The unique identifier of the verification check.
Type of verification check performed:
BUSINESS_VERIFICATION- Verification of the business entity of a Legal User.IDENTITY_DOCUMENT_VERIFICATION- Verification of the identity document of a Natural User or the legal representative of a Legal User.PERSONS_SIGNIFICANT_CONTROL- Verification of a person of significant control of a Legal User.
For more details, see the Verified data returned
Returned values: VALIDATED, REFUSED, REVIEW
The status of the verification check.
The date and time at which the check was created.
The date and time at which the check was last updated.
The data points collected and verified during the check.
The type of the data point. For more details, see the Verified data returned.
The value of the data point.
Was this page helpful?
Copy
// GET has no body parameters
Copy
{
"SessionId": "idnver_01JH2ZK1MKAMG5H2Q20M5K6020",
"Status": "VALIDATED",
"CreationDate": 1736340768,
"LastUpdate": 1736341038,
"Checks": [
{
"CheckId": "idnchc_01JH2ZQEX65TJ7NMANSPYB5JXR",
"Type": "BUSINESS_VERIFICATION",
"CheckStatus": "VALIDATED",
"CreationDate": 1736340913,
"LastUpdate": 1736340913,
"Data": [
{
"Type": "COMPANY_NAME",
"Value": "Top Consulting"
},
{
"Type": "COMPANY_NUMBER",
"Value": "123456789"
}
]
},
{
"CheckId": "idnchc_01JH2ZV6ZQDBT0VS1YKKPZC6GJ",
"Type": "IDENTITY_DOCUMENT_VERIFICATION",
"CheckStatus": "VALIDATED",
"CreationDate": 1736341036,
"LastUpdate": 1736341036,
"Data": [
{
"Type": "LEGAL_REPRESENTATIVE_FIRST_NAME",
"Value": "ALEX"
},
{
"Type": "LEGAL_REPRESENTATIVE_LAST_NAME",
"Value": "SMITH"
},
{
"Type": "LEGAL_REPRESENTATIVE_BIRTHDATE",
"Value": "665452800"
},
{
"Type": "LEGAL_REPRESENTATIVE_NATIONALITY",
"Value": "FR"
},
{
"Type": "LEGAL_REPRESENTATIVE_RESIDENCY",
"Value": "FR"
},
{
"Type": "DOCUMENT_TYPE",
"Value": "DRIVERS_LICENSE"
},
{
"Type": "DOCUMENT_NUMBER",
"Value": "12AB12345"
},
{
"Type": "DOCUMENT_EXPIRATION_DATE_UNIX",
"Value": "2046902400"
}
]
}
]
}