View 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 an IDV Session
See the status and basic details of an identity verification session
GET
/
v2.01
/
{ClientId}
/
identity-verifications
/
{IdvSessionId}
// GET has no body parameters
{
"Id": "idnver_01JH2ZK1MKAMG5H2Q20M5K6020",
"Tag": "Created using the Mangopay API Postman collection",
"CreationDate": 1736340768,
"HostedUrl": "https://user-verification.sandbox.mangopay.com/66ebfacebd780d434e8e6a9d?sessionId=677e75212400002f00a6edd0&redirectURL=https%3A%2F%2Fexample.com",
"Status": "VALIDATED",
"ReturnUrl": "https://example.com"
}
Path parameters
The unique identifier of the identity verification session.
Responses
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.
The URL to redirect the user to for the hosted identity verification session.
The status of the identity verification session:
- PENDING – The session is available on the
HostedUrl
, to which the user must be redirected to complete it. - VALIDATED – The session was successful.
- REFUSED – The session was refused.
- REVIEW – The session is under manual review by Mangopay.
- OUTDATED – The session is no longer valid (likely due to expired documents used during the session).
- TIMEOUT – The session timed out due to inactivity.
- ERROR – The session was not completed because an error occurred.
Max. length: 500
The URL to which the user is returned after the hosted identity verification session, regardless of the outcome.
{
"Id": "idnver_01JH2ZK1MKAMG5H2Q20M5K6020",
"Tag": "Created using the Mangopay API Postman collection",
"CreationDate": 1736340768,
"HostedUrl": "https://user-verification.sandbox.mangopay.com/66ebfacebd780d434e8e6a9d?sessionId=677e75212400002f00a6edd0&redirectURL=https%3A%2F%2Fexample.com",
"Status": "VALIDATED",
"ReturnUrl": "https://example.com"
}
// GET has no body parameters
Was this page helpful?
// GET has no body parameters
{
"Id": "idnver_01JH2ZK1MKAMG5H2Q20M5K6020",
"Tag": "Created using the Mangopay API Postman collection",
"CreationDate": 1736340768,
"HostedUrl": "https://user-verification.sandbox.mangopay.com/66ebfacebd780d434e8e6a9d?sessionId=677e75212400002f00a6edd0&redirectURL=https%3A%2F%2Fexample.com",
"Status": "VALIDATED",
"ReturnUrl": "https://example.com"
}