> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mangopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The UBO Declaration object

export const BeneficialOwner = ({content}) => <Tooltip tip="An individual who owns or holds a power of control over a legal entity, either directly or via a holding company, usually by owning more than 25% of the entity's share capital or voting rights.">
        {content}
    </Tooltip>;

### Description

<Warning>
  **Caution – Legacy endpoints being superseded by the hosted KYC/KYB solution**

  Mangopay's [hosted KYC/KYB solution](/guides/users/verification/hosted) is becoming mandatory for all platforms, and allows Legal Users to declare and verify all beneficial owners in the same [IDV Session](/api-reference/idv-sessions/idv-session-object) object.

  The [criteria defining beneficial owners](/guides/glossary#beneficial-owner-ubo) remain the same.
</Warning>

The UBO Declaration object is a container to provide information regarding the ultimate <BeneficialOwner content="beneficial owners" /> of a legal entity. In the API-only flow, it is a requirement for legal users with `LegalPersonType` of `BUSINESS` or `PARTNERSHIP`.

### Attributes

<ParamField body="Id" type="string">
  The unique identifier of the object.
</ParamField>

<ParamField body="UserId" type="string">
  The unique identifier of the user.
</ParamField>

<ParamField body="CreationDate" type="Unix timestamp">
  The date and time at which the object was created.
</ParamField>

<ParamField body="Status" type="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.
</ParamField>

<ParamField body="Reason" type="string">
  The reason for which the UBO Declaration was `REFUSED` or considered as `INCOMPLETE`.
</ParamField>

<ParamField body="Message" type="string">
  Additional information about why the UBO Declaration was refused or marked as incomplete, provided by Mangopay’s team.
</ParamField>

<ParamField body="Array (UBOs)" type="array">
  The list of UBOs attached to the UBO Declaration.

  <Expandable title="properties">
    <ParamField body="Object (UBO)" type="object">
      The UBO object created by the platform.

      <Expandable title="properties">
        <ParamField body="Id" type="string">
          The unique identifier of the object.
        </ParamField>

        <ParamField body="CreationDate" type="Unix timestamp">
          The date and time at which the object was created.
        </ParamField>

        <ResponseField name="LastName" type="string">
          Max. length: 100 characters

          The last name of the beneficial owner.
        </ResponseField>

        <ResponseField name="FirstName" type="string">
          Max. length: 100 characters

          The first name of the beneficial owner.
        </ResponseField>

        <ParamField body="Birthday" type="Unix timestamp">
          The date of birth of the user.

          Returned `null` if `UserCategory` is `PAYER`.

          **Note:** This is a Unix timestamp in UTC. Ensure you convert your timezone to UTC to avoid midnight being interpreted as the day before.
        </ParamField>

        <ParamField body="Nationality" type="string">
          The nationality of the user. 

          Returned `null` if `UserCategory` is `PAYER`.
        </ParamField>

        <ParamField body="Address" type="object">
          The postal address of the user.

          <Expandable title="properties">
            <ParamField body="AddressLine1" type="string">
              Max. length: 255 characters

              The first line of the address.
            </ParamField>

            <ParamField body="AddressLine2" type="string">
              Max. length: 255 characters

              The second line of the address.
            </ParamField>

            <ParamField body="City" type="string">
              Max. length: 255 characters

              The city of the address.
            </ParamField>

            <ParamField body="Region" type="string">
              Max. length: 255 characters

              Required if `Country` is US, CA, or MX.

              The region of the address.
            </ParamField>

            <ParamField body="PostalCode" type="string">
              Max. length: 255 characters

              The postal code of the address. The postal code can contain the following characters: alphanumeric, dashes, and spaces.
            </ParamField>

            <ParamField body="Country" type="string">
              Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats))

              The country of the address.
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="Birthplace" type="object">
          Information about the beneficial owner's place of birth.

          <Expandable title="properties">
            <ParamField body="City" type="string">
              The city in which the beneficial owner was born.
            </ParamField>

            <ParamField body="Country" type="string">
              Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats))

              The country in which the beneficial owner was born.
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="IsActive" type="boolean">
          Whether or not the UBO is considered in the declaration. To disregard a UBO, set this parameter to `false`. This action is irreversible.
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

### Related resources

<CardGroup cols={2}>
  <Card title="How to" href="/guides/users/verification/beneficial-owners/how-to">How to submit a UBO Declaration</Card>
  <Card title="Guide" href="guides/users/verification/beneficial-owners">Learn more about beneficial owners</Card>
</CardGroup>