> ## 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 object

### 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 object represents one beneficial owner in the legacy API-only KYC/KYB verification flow.

### Attributes

<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>

<ParamField body="LastName" type="string">
  Max. length: 100 characters

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

<ParamField body="FirstName" type="string">
  Max. length: 100 characters

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

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

  **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 beneficial owner.
</ParamField>

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

  <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>

### 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>