Skip to main content
GET
/
platform
/
admin
/
tenant
/
wallets
/
multisignature
/
{walletTenantId}
/
add_owner
Get add owner data
curl --request GET \
  --url https://api.example.com/platform/admin/tenant/wallets/multisignature/{walletTenantId}/add_owner
{
  "isSuccess": true,
  "isFailure": false,
  "error": null,
  "value": {
    "id": 42,
    "name": "Example"
  }
}

​
Description

Fetches a list of eligible EOA wallets that can be added as owners to a multisignature wallet. Only wallets that are not already owners are included in the response.

​
Input

  • walletTenantId (long, required) - The multisignature wallet tenant identifier

​
Output

Returns an containing:
  • walletTenantId (long) - The wallet tenant identifier
  • availableOwnerWallets (array) - List of EOA wallets that can be added as owners
  • currentOwnersCount (int) - Current number of owners
  • maximumOwners (int, optional) - Maximum allowed owners for this wallet

​
Examples

Request 
GET /api/platform/wallets/3001/owners/add
Response (200 OK) 
{
  "walletTenantId": 3001,
  "availableOwnerWallets": [
    {
      "walletTenantId": 4096,
      "walletName": "Candidate Owner 1",
      "walletAddress": "0xfedcba9876543210fedcba9876543210fedcba98"
    },
    {
      "walletTenantId": 4097,
      "walletName": "Candidate Owner 2",
      "walletAddress": "0x1111111111111111111111111111111111111111"
    }
  ],
  "currentOwnersCount": 3,
  "maximumOwners": 10
}

​
Errors

  • 400 Bad Request: Invalid wallet tenant identifier format.
  • 401 Unauthorized: Authentication token is missing or invalid.
  • 403 Forbidden: User does not have permission to view owner data.
  • 404 Not Found: Wallet does not exist or is not a multisignature wallet.
  • 500 Internal Server Error: An unexpected error occurred while retrieving owner addition data.

​
Notes

Only EOA wallets from the same tenant are eligible to be added as owners. Wallets that are already owners of this multisignature wallet are excluded from the available list.

Path Parameters

​
walletTenantId
integer<int64>
required

Identifier of the wallet tenant.

Query Parameters

​
api-version
string | null

Response

Owner addition data retrieved successfully.

Wrapper for API operation results containing success status, error information, and return value.

​
isSuccess
boolean

True if the operation completed successfully, false otherwise.

Example:

true

​
isFailure
boolean

True if the operation failed, false otherwise.

Example:

false

​
error
object

Error information returned when the operation fails.

Example:
{
  "code": "ValidationError",
  "message": "The request parameters failed validation.",
  "info": [
    "The Name field is required.",
    "The Id field must be greater than 0."
  ]
}
​
value
object

The result value returned when the operation is successful.

Example:
{}