Managees
Last updated
Last updated
The Managees module provides a set of API endpoints designed for managers to onboard and manage their linked managees within the platform. The endpoints facilitate various operations, from creating managee profiles to listing all managees and generating widget user references for enhanced user interaction with the platform's widgets.
API Endpoints for the Managees Module:
: This endpoint is used by managers to create a new customer profile for a personal customer. The user also inputs additional data necessary for KYC screening.
: Managers can use this endpoint to retrieve a list of all managees they have created. The list provides essential information about each managee, such as their ID, name, date added, verification status, and any associated widget references. This is a GET request with pagination capabilities to effectively manage large numbers of managees.
: (DEPRECATED) Retrieves a list of accounts belonging to a managee. You can filter the list by the managee's ID, the asset (currency), and control pagination with page number and size.
: This POST endpoint enables managers to create a widget user reference for their managees, which facilitates the managee's interaction with the platform's widgets. A widget user reference is associated with the managee, allowing for a more dynamic and engaging user experience within the platform interface.
These API calls are integral to managee account management as they allow for seamless operations concerning the create-list-manage lifecycle of managee profiles under a manager account. Through their use, managers can streamline operations, ensure account accuracy, and deliver a more refined platform experience to their managees.
Allows a manager to create a linked customer, referred to as a managee. The user provides additional information necessary for KYC screening. A file with proof of address is also required. The response contains a Jumio Link, from which the customer can enter and verify their identity information. A manager can set up a new customer account under their purview by entering the customer's (managee's) details into the system.
Endpoint: /api/v5/customer/managees/create
Method: POST
Request Body:
emailAddress (String, max length: 200): The email address of the new managee.
manageesReference (String, max length: 100): A unique reference to identify the managee.
parentCustomersId (Integer, nullable): ID of the managee's parent. It can be the manager's customer ID, or the ID of any of their managees.
fiatCurrencyCode (String, max length: 10): The fiat currency code for the managee's account (e.g., USD). Currently only "USD" is supported.
fullName (String, max length: 200): The managee's full legal name.
firstGivenName (String, max length: 100): The managee's first given name.
lastSurname (String, max length: 100): The managee's last surname, if the user has multiple surnames.
addressLine1 (String, max length: 200): The street address or equivalent for the managee.
addressLine2 (String, max length: 200, optional): Additional address information if necessary.
townCity (String, max length: 100): The town or city of the managee's address.
stateProvince (String, max length: 1000): The state, province, or equivalent area of the address.
postcode (String, max length: 50): The postcode or ZIP code associated with the managee's address.
addressCountryISO (String, max length: 3): The ISO country code of the managee's address.
phoneNumber (String, max length: 100): The managee's phone number.
dateOfBirth (String, ISO 8061): The managee's date of birth in "YYYY-MM-DD" format.
taxNumber (String, max length: 100): The managee's tax identification number.
nationalityISO (String, max length: 3): The ISO country code of the managee's nationality.
estimatedNetWorth (Decimal): Managee's estimated net worth (USD).
estimatedGrossAnnualIncome (Decimal): Managee's estimated gross annual income (USD).
otherBanks (String Array): Other banks at which managee has accounts.
bActivelyEmployed (Boolean): Is the managee actively employed.
employedCompanyName (String, max length: 200): Full name of managee's company.
employedJobTitle (String, max length: 200): Managee's job title.
monthlyTurnover(Decimal): Managee's monthly turnover (USD).
anticipatedTransactionActivity(Decimal): Managee's Anticipated transaction activity for the next 12 months (USD).
purchaseCryptoMonthlyVolume(Decimal): Managee's Purchasing Crypto - Monthly Volume.
purchaseCryptoAverageAmount(Decimal): Managee's Purchasing Crypto - Average Amount (USD).
purchaseCryptoTotalAmountPerMonth(Decimal): Managee's Purchasing Crypto - Total Amount Monthly (USD).
sellingCryptoMonthlyVolume(Decimal): Managee's Selling Crypto - Monthly Volume.
sellingCryptoAverageAmount(Decimal): Managee's Selling Crypto - Average Amount (USD).
sellingCryptoTotalAmountPerMonth(Decimal): Managee's Selling Crypto - Total Amount Monthly (USD).
totalMonthlyVolume (Decimal): Managee's Total for All Monthly Volume.
totalAverageAmount (Decimal): Managee's Total for All Average Amount (USD).
totalMonthlyAmount (Decimal): Managee's Total Amount Per Month (USD).
btcTradingPercentage (Decimal): Managee's Percentage (%) of Anticipated Trading Activity by Coin - BTC.
ethTradingPercentage (Decimal): Managee's Percentage (%) of Anticipated Trading Activity by Coin - ETH.
usdcTradingPercentage (Decimal): Managee's Percentage (%) of Anticipated Trading Activity by Coin - USDC.
otherCoinsTradingPercentage (Decimal): Managee's Percentage (%) of Anticipated Trading Activity by Coin - Other Coins.
bIrsTax (Boolean): Managee's agreement with "I confirm that I am personally up to date and compliant with IRS tax filing requirements".
bForeignAccountTax(Boolean): Managee's agreement with "I confirm that I am in full compliance with Foreign Account Tax Compliance Act (FACTA)".
bNotCriminal(Boolean): Managee's agreement with "I declare I have not been engaged in or have benefited from criminal conduct in any part of the world and funds which are subject to the proposed arrangement do not wholly or in part directly represent the proceeds of criminal conduct".
bAccurateInfo(Boolean): Managee's agreement with "I declare that the information given hereunder and in the documents requested hereby is to the best of your knowledge true and accurate as at the date hereof,and should there be any changes in the information so provided you undertake to promptly advise our law firm of the same in writing".
ProofOfAddressFile (String): Managee's proof of address file. Base 64 encoded JPEG or PNG data.
ProofOfAddressType (String): Type of proof of address file. Possible values: BankStatement, CouncilBill, CreditCardStatement, LeaseAgreement, LoanApplication, MortgageApplication, PhoneBill, TaxReturn, UtilityBill.
Salary
Salary
Savings
Savings
SelfEmployed
Self Employed
Loans
Loans/Borrowed Funds
DigitalAsset
Digital Asset OTC Desk
CryptoLoans
Crypto Loans
PeerToPeer
Peer to Peer Transfer
CreditDebit
Credit or Debit Services
Response Element Types:
id (Integer): Reference ID, not used here.
details (Object)
manageesId (Integer): Newly created managee's ID, used to identify the user in other API requests.
jumioLink (Integer): Link for customer to complete identity verification process.
status (String): "1" for success, "0" for error.
errors (Array): List of errors, if any.
Success Response Example:
Required
Named field missing
Invalid_Length
Named field length invalid
Invalid_Format
Named field format invalid
Username_Not_Available
User with requested email already exists
Currency_Invalid
Currency not supported
Nationality_Invalid
Requested user nationality not supported
Address_Country_Invalid
Address country not supported
Percentage_Invalid
Percentages must be between 0 and 100
Total_Percentage_Invalid
Total percentage must be at most 100
Type_Duplicated
Duplicate entries in array
IrsTax_Invalid
User must agree to terms
ForeignAccountTax_Invalid
User must agree to terms
NotCriminal_Invalid
User must agree to terms
AccurateInfo_Invalid
User must agree to terms
Retrieve a paginated list of basic data for all managees linked to the manager. Managers can view a list of all their linked customers, sortable and navigable through numerous pages.
Endpoint: /api/v2/customer/managees/list
Method: GET
Query Parameters:
PageNumber: Page to view
PageSize: Results per page
Success Response Parameters:
id (Integer): An identifier for the list operation; might not be used in the response.
details (Array of Objects): An array containing managee objects with the following structure:
manageesId (Integer): The unique ID of the managee user.
manageesReference (String): Your reference for the managee.
name (String): Managee’s full name.
addDate (DateTime): Date and time when the managee was created, formatted in ISO 8601.
verificationStatus (String): Current verification status of the managee ("Pending," "Accepted," or "Rejected").
widgetUserReference (String): Widget user reference associated with the managee, if any.
parentCustomersId (Integer): ID of the managee's parent customer.
pageSize (Integer): The number of results per page returned in the response.
pageNumber (Integer): The current page number in the paginated list.
numberOfPages (Integer): The total number of available pages.
status (String): Indicates the status code of the response ("1" for success).
errors (Array): Contains error details if any occurred during the request.
Response with Errors Parameters:
id (Integer): Reference identifier for the request; often not used with errors.
details (null): Typically null when errors are present.
status (String): Status code of the operation ("0" for errors).
errors (Array of Objects): An array of error objects, each containing:
fieldName (String): The field name that caused the error.
messageCode (String): Specific code indicating the error (e.g., "Invalid").
Invalid
Named parameter invalid
This endpoint retrieves a list of accounts belonging to a managee. You can filter the list by the managee's ID, the asset (currency), and control pagination with page number and size. This functionality is like a filterable list that shows all the accounts for individuals or entities managed by another party. It allows the user to see only specific accounts, sort it by the type of money in the account (like USD), and break the list into readable chunks (pages).
Endpoint: /api/v1/customer/manageeaccounts/list
Method: GET
Query Parameters:
ManageesId (Integer): Managee's ID for filtering (optional).
Asset (String): Asset code for filtering (optional).
PageNumber (Integer): The page number for pagination, default is 1 (optional).
PageSize (Integer): The number of records per page, default is 10 (optional).\
Response Body Parameters and Types:
id (Integer): A reference ID for the account list.
details (Array of Objects): A list of account objects, each with the following structure:
id (Integer): The unique ID for the account.
manageesId (Integer): The related managee’s ID for this account.
name (String): The name associated with the account.
routingNumber (String): The account routing number for financial transactions.
accountNumber (String): The specific account number.
asset (String): Currency code of the account’s asset.
totalBalance (Decimal): The total money held in the account.
availableBalance (Decimal): The funds available for withdrawal or spending.
pendingBalance (Decimal): Amounts that are in the process of being deposited or withdrawn.
bSuppressed (Boolean): Indicates whether the account is currently suppressed (hidden) or active.
dateAdded (String): Date and time the account was created, in ISO 8601 format.
pageSize (Integer): Numerical size of the current page in the paginated response.
pageNumber (Integer): Current page number within the paginated set.
numberOfPages (Integer): Total number of response pages available.
status (String): The operation's success status; '1' for success.
errors (Array): An array of error objects, detailing any issues encountered with the request.
Success Response Example:
The response returns a list of managee accounts with details including the account's name, routing number, account number, asset, balances, and addition date.
This endpoint allows the creation of a widget user reference for the managee to facilitate the use of the crypto widget. Special identifiers for managees are generated to give them access to easier checkouts, as customer information will already be provided.
Endpoint: /api/v1/customer/managees/createwidgetuser
Method: POST
Request Body:
manageesId (Integer): The managee's ID for who the widget user is being created.
widgetUserReference (String, max length 100): The widget user reference associated with the managee.
Success Response Parameters:
id (Integer): A reference ID for the createwidgetuser operation, not typically used in the response.
status (String): The status code of the operation ("1" for success).
errors (Array): An empty array, indicating that no errors occurred during the request.
Success Response Example:
Response Example with Errors:
Widget_Client_Not_Found
Manager does not have associated widget client
Managee_Not_Found
Managee’s Id is invalid
Managee_Not_Verified
Managee is not verified
Widget_User_Already_Exists
Managee already has an associated widget user
Already_Used
WidgetUserReference already used before
sourceFundsTypes (String Array): Source of Funds, with values from this .
purposeOfOpeningAccountTypes(String Array): Purpose of opening account, with values from this .
This endpoint is deprecated and may have functionality issues. This endpoint was replaced by the new endpoint (). Please use for this purpose.
Request query:
Response:
One time pass for the request
Request body parameters:
Response:
One time pass for the request
Request body parameters:
EmailAddress: Customer email address
ManageesReference: User reference for the customer
ParentCustomersId: Id of the customer's parent
FiatCurrencyCode: Card currency
FullName: Customer's full name
FirstGivenName: Customer's first give name
LastSurname: Customer's surname
TownCity: Customer's address town/city
AddressCountryISO: Customer's address country three letter ISO code
AddressLine1: Customer's address line 1
AddressLine2: Customer's address line 2
StateProvince: Customer's address state or province
Postcode: Customer's address postcode
PhoneNumber: Customer's phone number
DateOfBirth: Customer's date of birth
TaxNumber: Customer's tax number
NationalityISO: Customer's nationality country three letter ISO code
Occupation: Customer's occupation
SourceFundsTypes: Source of funds
OtherSourceOfFunds: Other Source of funds
EstimatedNetWorth: Estimated Net Worth
EstimatedGrossAnnualIncome: Estimated Gross Annual Income
OtherBanks: Customer's Other Banks
bActivelyEmployed: Are you actively employed?
EmployedCompanyName: Full Name of Company
EmployedJobTitle: Job title
PurposeOfOpeningAccountTypes: Purpose of opening account
MonthlyTurnover: Monthly Turnover
AnticipatedTransactionActivity: Anticipated transaction activity for the next 12 months
PurchaseCryptoMonthlyVolume: Cryptocurrency OTC Desk - Purchasing Crypto - Monthly Volume
PurchaseCryptoAverageAmount: Cryptocurrency OTC Desk - Purchasing Crypto - Average Amount (USD)
PurchaseCryptoTotalAmountPerMonth: Cryptocurrency OTC Desk - Purchasing Crypto - Total Amount Monthly (USD)
SellingCryptoMonthlyVolume: Cryptocurrency OTC Desk - Selling Crypto - Monthly Volume
SellingCryptoAverageAmount: Cryptocurrency OTC Desk - Selling Crypto - Average Amount (USD)
SellingCryptoTotalAmountPerMonth: ryptocurrency OTC Desk - Selling Crypto - Total Amount Per Month (USD)
TotalMonthlyVolume: Total for All Monthly Volume
TotalAverageAmount: Total for All Average Amount (USD)
TotalMonthlyAmount: Total Amount Per Month (USD)
BtcTradingPercentage: Percentage (%) of Anticipated Trading Activity by Coin - BTC
EthTradingPercentage: Percentage (%) of Anticipated Trading Activity by Coin - ETH
UsdcTradingPercentage: Percentage (%) of Anticipated Trading Activity by Coin - USDC
OtherCoinsTradingPercentage: Percentage (%) of Anticipated Trading Activity by Coin - Other Coins
bIrsTax: I confirm that I am personally up to date and compliant with IRS tax filing requirements
bForeignAccountTax: I confirm that I am in full compliance with Foreign Account Tax Compliance Act (FACTA)
bNotCriminal: I declare I have not been engaged in or have benefited from criminal conduct in any part of the world and funds which are subject to the proposed arrangement do not wholly or in part directly represent the proceeds of criminal conduct
bAccurateInfo: I declare that the information given hereunder and in the documents requested hereby is to the best of your knowledge true and accurate as at the date hereof,and should there be any changes in the information so provided you undertake to promptly advise our law firm of the same in writing
ProofOfAddressFile: Customer's proof of address file in base64 string format
ProofOfAddressType: Customer's proof of address document type. Possible values: BankStatement, CouncilBill, CreditCardStatement, LeaseAgreement, LoanApplication, MortgageApplication, PhoneBill, TaxReturn, UtilityBill Response:
ManageesId: Id of new customer
JumioLink: Link for customer to complete verification
Possible validation errors:
One time pass for the request
Their reference for the customer
Base 64 encoded JPEG or PNG data Max 10MB