Overview
User management
- Users
- User regulatory status
- User e-money
User verification
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
- Virtual IBAN
- Direct debits
- Web direct debits
APM pay-ins
- Apple Pay
- Bancontact
- 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
- Bank accounts
- Payouts
FX conversions
- Conversion rates
- Quotes
- Conversions
Transactions
- Transactions
Helpers
- API responses
- Country authorizations
- Webhooks
- Events
- Reports
Platform account
- Client
- Dashboard permissions
Create a UBO
{
"LastName": "Effertz",
"FirstName": "Michaela",
"Birthday": 652117514,
"Nationality": "FR",
"Address": {
"AddressLine1": "804 Hane Mountains",
"AddressLine2": "Adriel Overpass",
"City": "Paris",
"Region": "Île-de-France",
"PostalCode": "75001",
"Country": "FR"
},
"Birthplace": {
"City": "Paris",
"Country": "FR"
}
}
{
"Id": "ubo_m_01JH7TS5ZHW3R501ACJEKD5G39",
"CreationDate": 1736503498,
"LastName": "Effertz",
"FirstName": "Michaela",
"Birthday": 652117514,
"Nationality": "FR",
"Address": {
"AddressLine1": "804 Hane Mountains",
"AddressLine2": "Adriel Overpass",
"City": "Paris",
"Region": "Île-de-France",
"PostalCode": "75001",
"Country": "FR"
},
"Birthplace": {
"City": "Paris",
"Country": "FR"
},
"IsActive": true
}
Read more about the UBO object →
Path parameters
The unique identifier of the user.
The unique identifier of the UBO Declaration.
Body parameters
Max. length: 100 characters
The last name of the beneficial owner.
Max. length: 100 characters
The first name of the beneficial owner.
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.
Format: Two-letter country code (ISO 3166-1 alpha-2 format)
The nationality of the beneficial owner.
The postal address of the beneficial owner.
Max. length: 255 characters
The first line of the address.
Max. length: 255 characters
The second line of the address.
Max. length: 255 characters
The city of the address.
Max. length: 255 characters
Required if Country is US, CA, or MX.
The region of the address.
Max. length: 255 characters
The postal code of the address. The postal code can contain the following characters: alphanumeric, dashes, and spaces.
Format: Two-letter country code (ISO 3166-1 alpha-2 format)
The country of the address.
Information about the beneficial owner’s place of birth.
The city in which the beneficial owner was born.
Format: Two-letter country code (ISO 3166-1 alpha-2 format)
The country in which the beneficial owner was born.
Responses
The unique identifier of the object.
The date and time at which the object was created.
Max. length: 100 characters
The last name of the beneficial owner.
Max. length: 100 characters
The first name of the beneficial owner.
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.
The nationality of the beneficial owner.
The postal address of the beneficial owner.
Max. length: 255 characters
The first line of the address.
Max. length: 255 characters
The second line of the address.
Max. length: 255 characters
The city of the address.
Max. length: 255 characters
The region of the address. This field is optional except if the Country is US, CA, or MX.
Max. length: 255 characters
The postal code of the address. The postal code can contain the following characters: alphanumeric, dashes, and spaces.
Format: Two-letter country code (ISO 3166-1 alpha-2 format)
The country of the address.
Information about the beneficial owner’s place of birth.
The city in which the beneficial owner was born.
Format: Two-letter country code (ISO 3166-1 alpha-2 format)
The country in which the beneficial owner was born.
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.
{
"Message": "You can not create more than 15 UBO for a declaration",
"Type": "invalid_action",
"Id": "f5c1f9c7-bafa-4fe9-b5b1-2b005d0e6f8a",
"Date": 1698759679.0,
"errors": null
}
{
"Message": "One or several required parameters are missing or incorrect. An incorrect resource ID also raises this kind of error.",
"Type": "param_error",
"Id": "2951739b-416e-43a4-a40b-8e8d6ba52719",
"Date": 1717664987.0,
"errors": {
"Region": "The Region is a required field for this Country"
}
}
{
"Id": "ubo_m_01JH7TS5ZHW3R501ACJEKD5G39",
"CreationDate": 1736503498,
"LastName": "Effertz",
"FirstName": "Michaela",
"Birthday": 652117514,
"Nationality": "FR",
"Address": {
"AddressLine1": "804 Hane Mountains",
"AddressLine2": "Adriel Overpass",
"City": "Paris",
"Region": "Île-de-France",
"PostalCode": "75001",
"Country": "FR"
},
"Birthplace": {
"City": "Paris",
"Country": "FR"
},
"IsActive": true
}
{
"LastName": "Effertz",
"FirstName": "Michaela",
"Birthday": 652117514,
"Nationality": "FR",
"Address": {
"AddressLine1": "804 Hane Mountains",
"AddressLine2": "Adriel Overpass",
"City": "Paris",
"Region": "Île-de-France",
"PostalCode": "75001",
"Country": "FR"
},
"Birthplace": {
"City": "Paris",
"Country": "FR"
}
}
Was this page helpful?
{
"LastName": "Effertz",
"FirstName": "Michaela",
"Birthday": 652117514,
"Nationality": "FR",
"Address": {
"AddressLine1": "804 Hane Mountains",
"AddressLine2": "Adriel Overpass",
"City": "Paris",
"Region": "Île-de-France",
"PostalCode": "75001",
"Country": "FR"
},
"Birthplace": {
"City": "Paris",
"Country": "FR"
}
}
{
"Id": "ubo_m_01JH7TS5ZHW3R501ACJEKD5G39",
"CreationDate": 1736503498,
"LastName": "Effertz",
"FirstName": "Michaela",
"Birthday": 652117514,
"Nationality": "FR",
"Address": {
"AddressLine1": "804 Hane Mountains",
"AddressLine2": "Adriel Overpass",
"City": "Paris",
"Region": "Île-de-France",
"PostalCode": "75001",
"Country": "FR"
},
"Birthplace": {
"City": "Paris",
"Country": "FR"
},
"IsActive": true
}