View the Verified Identity of a User

GET

/v2.01/:ClientId/users/:UserId/verified-identity

GET

/v2.01/:ClientId/users/:UserId/verified-identity

curl https://api.sandbox.mangopay.com/v2.01/{ClientId}/users/{UserId}/verified-identity \
     -H "Authorization: Bearer <token>"

{
  "Address": {
    "AddressLine1": "10 rue de la Paix",
    "AddressLine2": null,
    "City": "Paris",
    "Country": "FR",
    "PostalCode": "75002",
    "Region": null
  },
  "BirthdayDate": "1990-01-01T00:00:00Z",
  "ClientId": "your-client-id",
  "CountryOfResidence": "FR",
  "Documents": [
    {
      "DocumentExpiryDate": "2030-06-30T00:00:00Z",
      "DocumentType": "IDENTITY_PROOF",
      "DocumentUrls": [
        "https://d1a2b3c4d5e6f7.cloudfront.net/kyc/user_m_01JTG7NDTE52MZCCF50QHJ870A/identity-proof-page-1.pdf?Expires=1771592800&Signature=EXAMPLE&Key-Pair-Id=EXAMPLE"
      ],
      "Status": "VALIDATED"
    }
  ],
  "FirstName": "Alex",
  "LastName": "Martin",
  "Nationality": "FR",
  "UserId": "user_m_01JTG7NDTE52MZCCF50QHJ870A",
  "UserType": "NATURAL"
}

Retrieve the identity information and verification documents validated by Mangopay for a User, based on their UserId.

The API response depends on the user’s UserType:

NATURAL – The verified personal identity and ID document.
LEGAL_BUSINESS, LEGAL_ORGANIZATION, LEGAL_PARTNERSHIP, LEGAL_SOLETRADER – The verified information about the legal entity, the business documents, plus the declared legal representative or persons of significant control and their ID document(s).

The endpoint returns a verified identity if:

The endpoint is activated for your platform’s ClientId
The user’s KYC/KYB verification is validated (their KYCLevel is REGULAR)
The user exists for the ClientId

A user whose verification is not validated returns a 400 error rather than a partial or declared identity.

Note – Feature activation required

This endpoint requires activation for your platform – contact Mangopay via the Dashboard to get started.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

If your platform is using a proxy to take SCA-triggering action on behalf of users, you also need to integrate mTLS authentication and use the api-mtls base URL.

Path parameters

ClientIdstringRequired

Platform's API account identifier, associated with the API key.

UserIdstringRequired

The unique identifier of the user.

Response

Success

Naturalobject

Response if the user’s UserType is NATURAL.

Identity properties can be returned null even for a user whose KYC/KYB verification is validated, because the data available depends on the verification received for that user.

Legalobject

Response if the user’s UserType is LEGAL_BUSINESS, LEGAL_ORGANIZATION, LEGAL_PARTNERSHIP, or LEGAL_SOLETRADER.

Identity properties can be returned null even for a user whose KYC/KYB verification is validated, because the data available depends on the verification received for that user.

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error