IDV sessions
List IDV Sessions for a User
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
IDV sessions
List IDV Sessions for a User
Retrieve key details of all hosted KYC/KYC sessions attempted for a user
GET
/
v2.01
/
{ClientId}
/
users
/
{UserId}
/
identity-verifications
// GET has no body parameters
[
{
"Id": "idnver_01JTG8BTG92TTRP5VSNV35ZYGM",
"Status": "PENDING",
"CreationDate": 1746449121,
"LastUpdate": null
},
{
"Id": "idnver_01JTGAXGJRVNCD9K4CEM311M4Z",
"Status": "REFUSED",
"CreationDate": 1746449852,
"LastUpdate": 1746449945
}
]
Path parameters
The unique identifier of the user.
Responses
The unique identifier of the object.
The status of the overall IDV Session:
PENDING
– The uniqueHostedUrl
for the session has not yet been submitted by the user. This temporary state can transition toVALIDATED
,REFUSED
, orREVIEW
.REVIEW
– One or more automated checks was neither successful nor refused, so the session was sent for manual review by Mangopay’s teams. This temporary state is only applicable to Legal users and can transition toREFUSED
orVALIDATED
.VALIDATED
– - The session was validated and the User became KYC/KYB verified (indicated by the User object’sKYCLevel
). When theStatus
changes toVALIDATED
, the verified data inChecks.Data
is used to replace existing data in the User object.REFUSED
– The session was refused and the User is not KYC/KYB verified. TheChecks.CheckStatus
shows which checks wereREFUSED
and theChecks.Reasons
shows the refused reason types and comment (which is custom text in the case of manual review for Legal users).OUTDATED
– The session is not valid because the user’s KYC/KYB verification status was downgraded by Mangopay.
The date and time at which the object was created.
The date and time at which the session was last updated.
[
{
"Id": "idnver_01JTG8BTG92TTRP5VSNV35ZYGM",
"Status": "PENDING",
"CreationDate": 1746449121,
"LastUpdate": null
},
{
"Id": "idnver_01JTGAXGJRVNCD9K4CEM311M4Z",
"Status": "REFUSED",
"CreationDate": 1746449852,
"LastUpdate": 1746449945
}
]
// GET has no body parameters
Was this page helpful?
// GET has no body parameters
[
{
"Id": "idnver_01JTG8BTG92TTRP5VSNV35ZYGM",
"Status": "PENDING",
"CreationDate": 1746449121,
"LastUpdate": null
},
{
"Id": "idnver_01JTGAXGJRVNCD9K4CEM311M4Z",
"Status": "REFUSED",
"CreationDate": 1746449852,
"LastUpdate": 1746449945
}
]