View a UBO Declaration
View a UBO Declaration
Authentication
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.
For all platforms, the public IP address from which the API call originates must be declared in the IP allowlist for the corresponding Client ID, in both Production and Sandbox.
Path parameters
Response
Max length: 128 characters (see data formats for details)
The unique identifier of the object.
Unix timestamp (UTC) of the date and time the object was created.
Unix timestamp (UTC) of the date and time the UBO Declaration was processed by Mangopay’s team.
Returned values: CREATED, VALIDATION_ASKED, INCOMPLETE, VALIDATED, REFUSED
The status of the declaration:
CREATED– The UBO Declaration is created, but not submitted yet.VALIDATION_ASKED– The UBO Declaration is submitted for validation.INCOMPLETE– The UBO Declaration is deemed incomplete by Mangopay teams.VALIDATED– The UBO Declaration is validated by Mangopay’s team.REFUSED– The UBO Declaration is rejected by Mangopay’s team. You can learn more about the reasons for refusal in theReasonandMessagefields.
The reason for which the UBO Declaration was REFUSED or considered as INCOMPLETE.