GET
/
v2.01
/
{ClientId}
/
kyc
/
ubodeclarations
/
{UboDeclarationId}

Read more about the UBO Declaration object →

Path parameters

UboDeclarationId
string

The unique identifier of the UBO Declaration.

Responses

Id
string

The unique identifier of the object.

UserId
string

The unique identifier of the user.

CreationDate
timestamp

The date and time at which the object was created.

ProcessedDate
timestamp

The date and time at which the UBO Declaration was processed by Mangopay’s team.

Status
string

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 the Reason and  Message fields.
Reason
string

The reason for which the UBO Declaration was REFUSED or considered as INCOMPLETE.

Message
string

Additional information about why the UBO Declaration was refused or marked as incomplete, provided by Mangopay’s team.

Ubos
array

The list of UBOs attached to the UBO Declaration.

Object (UBO)
object

The UBO object created by the platform.

Id
string

The unique identifier of the object.

CreationDate
timestamp

The date and time at which the object was created.

LastName
string

Max. length: 100 characters

The last name of the beneficial owner.

Nationality
string

The nationality of the beneficial owner.

Address
object

The postal address of the beneficial owner.

Birthplace
object

Information about the beneficial owner’s place of birth.

IsActive
boolean

Whether or not the UBO is considered in the declaration. To disregard a UBO, this parameter must be set to false. This action is irreversible.