Mangopay docs home page
Search...
⌘K
Ask AI
Contact sales
Dashboard
Dashboard
Search...
Navigation
UBO declarations
The UBO object
Integration
Guides
API reference
Overview
Introduction
API keys
Authentication
Rate limiting
Filtering and sorting
Pagination
Idempotency
Data formats
Data availability periods
User management
Users
User regulatory status
User e-money
User verification
IDV sessions
User data format
KYC documents
UBO declarations
The UBO Declaration object
POST
Create a UBO Declaration
The UBO object
POST
Create a UBO
PUT
Submit a UBO Declaration
PUT
Update a UBO
GET
View a UBO Declaration
GET
View a UBO
GET
List UBO Declarations for a User
Wallets
User wallets
Client wallets
Cards
Card registrations
Cards
Metadata
Card validations
Card pay-ins
Direct card pay-ins
Recurring card pay-ins
Preauthorizations
Deposit preauthorizations
Web card pay-ins
Banking pay-ins
Bank wires
Pay by bank
Virtual IBAN
Direct debits
Web direct debits
APM pay-ins
Apple Pay
Bancontact
Bizum
BLIK
Giropay
Google Pay
iDEAL
Klarna
MB WAY
Multibanco
Payconiq
PayPal
Satispay
Swish
TWINT
Transfers
Transfers
Refunds
Refunds
Disputes
Disputes
Dispute documents
Repudiations
Dispute settlement
Payouts
Recipients
Bank accounts
Payouts
FX conversions
Conversion rates
Quotes
Conversions
Transactions
Transactions
Echo
Intents
Settlements
Helpers
API responses
Country authorizations
Webhooks
Events
Reports
Platform account
Client
Dashboard permissions
On this page
Description
Attributes
Related resources
UBO declarations
The UBO object
Copy page
Copy page
Description
The UBO object represents one beneficial owner. Please note that:
The
Status
of the UBO Declaration must be
CREATED
to create a UBO.
The UBO Declaration can contain up to 15 UBOs.
Attributes
Id
string
The unique identifier of the object.
CreationDate
Unix timestamp
The date and time at which the object was created.
LastName
string
Max. length: 100 characters
The last name of the beneficial owner.
FirstName
string
Max. length: 100 characters
The first name of the beneficial owner.
Birthday
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.
Nationality
string
The nationality of the beneficial owner.
Address
object
The postal address of the beneficial owner.
Show properties
AddressLine1
string
Max. length: 255 characters
The first line of the address.
AddressLine2
string
Max. length: 255 characters
The second line of the address.
City
string
Max. length: 255 characters
The city of the address.
Region
string
Max. length: 255 characters
Required if
Country
is US, CA, or MX.
The region of the address.
PostalCode
string
Max. length: 255 characters
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
)
The country of the address.
Birthplace
object
Information about the beneficial owner’s place of birth.
Show properties
City
string
The city in which the beneficial owner was born.
Country
string
Format: Two-letter country code (
ISO 3166-1 alpha-2 format
)
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, set this parameter to
false
. This action is irreversible.
Related resources
How to
How to submit a UBO Declaration
Guide
Learn more about beneficial owners
Was this page helpful?
Yes
No
Create a UBO Declaration
Create a UBO
Assistant
Responses are generated using AI and may contain mistakes.