API - August 21, 2026 | Mangopay docs

Added

Endpoint to retrieve a User’s verified identity

Platforms for which the Underwriting API is activated can now retrieve the identity information and verification documents validated by Mangopay for a user, using a dedicated endpoint:

GET View a User’s Verified Identity

The payload returned depends on the user’s UserType, which your platform should use to determine the payload rather than the presence of an optional property:

NATURAL – The verified personal identity of the user and their documents.
LEGAL_BUSINESS, LEGAL_ORGANIZATION, LEGAL_PARTNERSHIP, LEGAL_SOLETRADER – The verified company information, the legal representative, and, where available, the persons with significant control (PSCs) and their documents.

For a Legal User, the array to use depends on the verification flow: LegalRepresentatives is returned for users verified with KYC Documents, while Pscs is returned for users verified with hosted KYC/KYB.

The endpoint returns a verified identity only for users whose KYC/KYB verification is validated, and never a partial or declared identity. Each document is returned with signed DocumentUrls that grant access for a limited validity period only, so download the document before the URL expires and call the endpoint again if you need access afterwards.

Read more about the Verified Identity object →

The endpoint requires an access token with the underwriting.user.kyc read permission. Contact Mangopay to request activation of the Underwriting API for your platform.