---
title: "Submit a UBO Declaration"
method: PUT
path: "/v2.01/{ClientId}/users/{UserId}/kyc/ubodeclarations/{UboDeclarationId}"
tags: ["uboDeclarations"]
---

# Submit a UBO Declaration

`PUT /v2.01/{ClientId}/users/{UserId}/kyc/ubodeclarations/{UboDeclarationId}`

<Warning icon="fa-regular fa-triangle-exclamation">
**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>

Submitting a UBO Declaration consists in updating the object `Status` parameter value to `VALIDATION_ASKED`.

From there, Mangopay Compliance team will validate, indicate as incomplete, or reject the declaration.

## Path parameters

- `ClientId` string, required
- `UserId` string, required
- `UboDeclarationId` string, required

## Headers

- `Authorization` string, required

## Request body

- SubmitADisputeDocumentRequest
  - `Status` string, required — **Allowed values:** `VALIDATION_ASKED` The status of the dispute document.

## Response `200`

Success

- UBODeclarationResponse
  - `Id` string — Max length: 128 characters (see [data formats](/api-reference/overview/data-formats) for details) The unique identifier of the object.
  - `UserId` string — The unique identifier of the user.
  - `CreationDate` integer — Unix timestamp (UTC) of the date and time the object was created.
  - `ProcessedDate` integer — Unix timestamp (UTC) of the date and time 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` UboDeclarationResponseUbosItems[] — The list of UBOs attached to the UBO Declaration.
    - `Object (UBO)` UboDeclarationResponseUbosItemsObjectUbo — The UBO object created by the platform.
      - `Id` string — Max length: 128 characters (see [data formats](/api-reference/overview/data-formats) for details) The unique identifier of the object.
      - `CreationDate` integer — Unix timestamp (UTC) of the date and time the object was created.
      - `LastName` string — The last name of the beneficial owner.
      - `Nationality` string — The nationality of the beneficial owner.
      - `Address` Address — The postal address.
        - `AddressLine1` string — The first line of the address.
        - `AddressLine2` string — The second line of the address.
        - `City` string — The city of the address.
        - `Region` string — Required if `Country` is US, CA, or MX. The region of the address.
        - `PostalCode` string — The postal code of the address. The postal code can contain the following characters: alphanumeric, dashes, and spaces.
        - `Country` string — Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats)) The country of the address.
      - `Birthplace` UboDeclarationResponseUbosItemsObjectUboBirthplace — Information about the beneficial owner's place of birth.
        - `City` string — The city in which the beneficial owner was born.
        - `Country` 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.
      - `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.

---

[API](https://skmtc.dev/mangopay/apis/api-reference.md) · [All operations](https://skmtc.dev/mangopay/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mangopay/api-reference/revisions/fafbd0c69654/schema)