> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.mangopay.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.mangopay.com/_mcp/server. # The Verified Identity object ### Description > **Note** > > **Note – Feature activation required** > > This endpoint requires activation for your platform – contact Mangopay [via the Dashboard](https://hub.mangopay.com/) to get started. The Verified Identity object contains information that Mangopay obtained during the customer due diligence process. The payload returned depends on the user's `UserType`: * `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. Use the `UserType` to determine which payload is returned, rather than the presence of an optional property. Identity properties can be returned `null`, and the `Documents`, `LegalRepresentatives`, and `Pscs` arrays can be empty, even for a user whose KYC/KYB verification is validated, because the data available depends on the verification received for that user. > **Warning** > > **Caution – Document URLs expire** > > The `DocumentUrls` of each document are signed URLs generated when the endpoint is called, and they grant access for a limited validity period only. Download the document before the URL expires, and call the endpoint again to obtain a new URL if you need access afterwards. > > Do not cache, persist, or share `DocumentUrls`, and do not use them as document identifiers. ### Attributes ### Schema (`ViewUserVerifiedIdentityResponse`) ```yaml components: schemas: VerifiedIdentityAddress: type: object properties: AddressLine1: type: - string - 'null' description: The first line of the address. AddressLine2: type: - string - 'null' description: The second line of the address. City: type: - string - 'null' description: The city of the address. Region: type: - string - 'null' description: The state, region, or province of the address. PostalCode: type: - string - 'null' description: The postal code of the address. Country: type: - string - 'null' description: >- Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats)) The country of the address. description: >- The verified postal address. This property is omitted from the response if no usable verified address is available. title: VerifiedIdentityAddress VerifiedIdentityDocument: type: object properties: DocumentType: type: string description: >- **Example value:** `IDENTITY_PROOF` The type of the verification document. Treat this as an extensible value, because further values can be returned. Status: type: string description: >- **Example value:** `VALIDATED` The status returned for the document. Treat this as an extensible value, because further values can be returned. DocumentExpiryDate: type: - string - 'null' description: |- Format: ISO 8601 date-time (for example, `2030-06-30T00:00:00Z`) The expiry date of the document, if applicable. DocumentUrls: type: array items: type: string description: >- The signed download URLs of the pages of the document, in page order. Each URL is generated when the endpoint is called and grants access for a limited validity period only, which is not returned as a separate property. Download the document before the URL expires, and call the endpoint again to obtain a new URL if you need access afterwards. Do not cache, persist, or share these URLs, and do not use them as document identifiers. description: >- A verification document validated by Mangopay. Only documents whose expiry date is today or later are returned, along with documents that have no expiry date. Documents are not filtered on `Status`. title: VerifiedIdentityDocument NaturalUserVerifiedIdentityResponse: type: object properties: ClientId: type: string description: Platform's API account identifier, as sent in the request. UserId: type: string description: The unique identifier of the user, as sent in the request. UserType: type: string description: |- **Returned value:** `NATURAL` The type of the user, which determines the payload returned. FirstName: type: - string - 'null' description: The verified first name of the user. LastName: type: - string - 'null' description: The verified last name of the user. BirthdayDate: type: - string - 'null' description: |- Format: ISO 8601 date-time (for example, `1990-01-01T00:00:00Z`) The verified date of birth of the user. Nationality: type: - string - 'null' description: >- Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats)) The verified nationality of the user. CountryOfResidence: type: - string - 'null' description: >- Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats)) The verified country of residence of the user. Address: $ref: '#/components/schemas/VerifiedIdentityAddress' Documents: type: array items: $ref: '#/components/schemas/VerifiedIdentityDocument' description: >- The non-expired verification documents of the user. The array is empty if no document is returned. description: >- 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. title: NaturalUserVerifiedIdentityResponse VerifiedIdentityLegalRepresentative: type: object properties: FirstName: type: - string - 'null' description: The verified first name of the legal representative. LastName: type: - string - 'null' description: The verified last name of the legal representative. BirthdayDate: type: - string - 'null' description: |- Format: ISO 8601 date-time (for example, `1985-05-15T00:00:00Z`) The verified date of birth of the legal representative. Nationality: type: - string - 'null' description: >- Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats)) The verified nationality of the legal representative. CountryOfResidence: type: - string - 'null' description: >- Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats)) The verified country of residence of the legal representative. description: The verified legal representative of the company. title: VerifiedIdentityLegalRepresentative VerifiedIdentityPSC: type: object properties: PscExternalId: type: string description: The unique identifier of the PSC. PscType: type: string description: >- **Example values:** `DIRECTOR`, `SHAREHOLDER` The role or type of the PSC. Treat this as an extensible value, because further values can be returned. FirstName: type: - string - 'null' description: The verified first name of the PSC. LastName: type: - string - 'null' description: The verified last name of the PSC. BirthdayDate: type: - string - 'null' description: |- Format: ISO 8601 date-time (for example, `1978-09-20T00:00:00Z`) The verified date of birth of the PSC. Nationality: type: - string - 'null' description: >- Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats)) The verified nationality of the PSC. CountryOfResidence: type: - string - 'null' description: >- Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats)) The verified country of residence of the PSC. Documents: type: array items: $ref: '#/components/schemas/VerifiedIdentityDocument' description: >- The non-expired verification documents of the PSC. The array is empty if no document is returned. description: The verified person with significant control (PSC) of the company. title: VerifiedIdentityPSC LegalUserVerifiedIdentityResponse: type: object properties: ClientId: type: string description: Platform's API account identifier, as sent in the request. UserId: type: string description: The unique identifier of the user, as sent in the request. UserType: type: string description: >- **Returned values:** `LEGAL_BUSINESS`, `LEGAL_ORGANIZATION`, `LEGAL_PARTNERSHIP`, `LEGAL_SOLETRADER` The type of the user, which determines the payload returned. CompanyName: type: - string - 'null' description: The verified name of the company. CompanyNumber: type: string description: >- The verified registration number of the company. This property is omitted from the response if the company number is unavailable. HeadquartersAddress: $ref: '#/components/schemas/VerifiedIdentityAddress' LegalRepresentatives: type: array items: $ref: '#/components/schemas/VerifiedIdentityLegalRepresentative' description: >- The verified legal representatives of the company, returned for users verified with [KYC Documents](/api-reference/kyc-documents/kyc-document-object). It represents the legal representative verified in the main verification session, and currently contains zero or one legal representative. Users verified with the [hosted KYC/KYB solution](/guides/users/verification/hosted) return their persons with significant control (PSCs) in `Pscs` instead, so do not rely on `LegalRepresentatives` being populated for them. Documents: type: array items: $ref: '#/components/schemas/VerifiedIdentityDocument' description: >- The non-expired documents of the main verification session, which for a Legal User is the legal representative's session. The array is empty if no document is returned. Pscs: type: array items: $ref: '#/components/schemas/VerifiedIdentityPSC' description: >- The verified persons with significant control (PSCs) of the company and their documents, returned for users verified with the [hosted KYC/KYB solution](/guides/users/verification/hosted). The array is empty if no PSC is returned. Do not use `LegalRepresentatives` as a substitute for the data returned in `Pscs`. description: >- 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. title: LegalUserVerifiedIdentityResponse ViewUserVerifiedIdentityResponse: oneOf: - $ref: '#/components/schemas/NaturalUserVerifiedIdentityResponse' - $ref: '#/components/schemas/LegalUserVerifiedIdentityResponse' title: ViewUserVerifiedIdentityResponse ```