Swipelux
Business Customers

Shareholders & UBOs

Manage Ultimate Beneficial Owners and shareholders

Add and manage Ultimate Beneficial Owners (UBOs) and shareholders with >25% ownership or control.

Add Shareholder

POST /v1/businesses/:id/shareholders

Request Example

POST https://wallet.swipelux.com/v1/businesses/biz_cK69MttD5nAUAbud1B/shareholders
Content-Type: application/json
X-API-Key: your_api_key
 
{
  "residentCountry": "DE",
  "givenName": "John",
  "lastName": "Doe",
  "sharePercentage": 51,
  "joiningDate": "2020-01-15",
  "businessEmail": "john.doe@acme-invest.example.com",
  "position": "Managing Director",
  "uboOwnership": true,
  "uboIsSigner": true,
  "uboHasControl": true
}

Request Fields

FieldTypeRequiredDescription
residentCountrystringYesCountry of residence (ISO 3166-1 alpha-2)
givenNamestringYesFirst/given name
lastNamestringYesLast/family name
sharePercentagenumberYesOwnership percentage (0-100)
joiningDatestringYesDate joined company (ISO 8601)
businessEmailstringYesBusiness email address
positionstringYesPosition/title in company
uboOwnershipbooleanYesHas >25% ownership
uboIsSignerbooleanYesAuthorized signer for company
uboHasControlbooleanYesHas control over company decisions

Response

{
  "id": 1,
  "businessId": "biz_cK69MttD5nAUAbud1B",
  "residentCountry": "DE",
  "givenName": "John",
  "lastName": "Doe",
  "sharePercentage": 51,
  "joiningDate": "2020-01-15",
  "businessEmail": "john.doe@acme-invest.example.com",
  "position": "Managing Director",
  "uboOwnership": true,
  "uboIsSigner": true,
  "uboHasControl": true,
  "createdAt": "2025-10-17T16:00:00Z"
}

Update Shareholder

PATCH /v1/businesses/:id/shareholders/:shareholderId

Request Example

PATCH https://wallet.swipelux.com/v1/businesses/biz_cK69MttD5nAUAbud1B/shareholders/1
Content-Type: application/json
X-API-Key: your_api_key
 
{
  "sharePercentage": 60,
  "position": "CEO"
}

All fields from the create request are optional in updates. Only provided fields will be updated.

Delete Shareholder

DELETE /v1/businesses/:id/shareholders/:shareholderId

Request Example

DELETE https://wallet.swipelux.com/v1/businesses/biz_cK69MttD5nAUAbud1B/shareholders/1
X-API-Key: your_api_key

UBO Requirements

You must declare all individuals who meet any of these criteria:

  • Own >25% of the company shares
  • Control >25% of voting rights
  • Exercise significant control over management decisions
  • Are authorized signers on company accounts
  • Are ultimate beneficial owners through indirect ownership

Common Positions

Typical UBO positions requiring declaration:

  • CEO, Managing Director, President
  • CFO, Treasurer
  • Majority Shareholders
  • Board Members with control
  • Trust Beneficiaries (if applicable)

Multiple Shareholders

For companies with multiple UBOs, add each separately:

// Add majority shareholder
await fetch(`/v1/businesses/${businessId}/shareholders`, {
  method: 'POST',
  body: JSON.stringify({
    givenName: 'Anna',
    lastName: 'Schmidt',
    sharePercentage: 60,
    uboOwnership: true,
    // ...
  })
});
 
// Add minority shareholder with control
await fetch(`/v1/businesses/${businessId}/shareholders`, {
  method: 'POST',
  body: JSON.stringify({
    givenName: 'Peter',
    lastName: 'Mueller',
    sharePercentage: 40,
    uboHasControl: true,
    // ...
  })
});

Next Steps

Activity Information

Declare high-risk activities and sanctioned country involvement

Add wallets to customer POST

Create wallets for a customer to hold cryptocurrencies

On this page