Joint accounts

A joint account is one brokerage account owned by two people. Both owners can trade, deposit, and withdraw. This is different from adding someone as an authorized user. A joint owner is a real owner, with their own identity check and their own tax form.

Requirements and limitations

Requirements

A joint account needs two people who already exist as individual Users under your partner. There is no combined "create two people at once" call. Create each User the normal way, one at a time, with the existing Creating a user flow.

  • Both Users must pass identity verification (KYC, or Know Your Customer).
  • Both Users must be under the same partner. A joint account cannot mix owners from two partners.
  • Both Users must be individual traders. A business entity cannot be a joint owner.
  • Both Users must complete their disclosures, the same agreements a single owner signs today.

Order of operations: Create and approve owner one, then create and approve owner two, before you create the joint account. If either owner is not fully set up, the account will not be open.

Limitations

Joint accounts can trade equities, fixed income and mutual funds.

  • Options are not supported. Requests to enroll a joint account in options are rejected.
  • Fully paid securities lending (FPSL) is not supported. Requests to enroll a joint account in FPSL are rejected.
  • Transfers between a joint account and an individual account are not supported. Transfers work joint-to-joint only.
  • More than two owners are not supported.
  • Owner death has no self-serve API flow yet. DriveWealth handles it manually today.
  • A person can be the primary owner of only one margin account at DriveWealth, and LPMA counts as margin. If either owner already has an individual LPMA or margin account, open the joint account as CASH.

Create the joint account

Create the account with the same Create Account call (POST /accounts) you use for any account, plus two joint-specific fields.

curl --request POST \
     --url https://bo-api.drivewealth.io/back-office/accounts \
     --header 'accept: application/json' \
     --header 'authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \
     --header 'content-type: application/json' \
     --header 'dw-client-app-key: {{YOUR_APP_KEY}}' \
     --data '{
  "userID": "123e4567-e89b-12d3-a456-000000000004",
  "accountType": "LIVE",
  "accountManagementType": "JOINT_SELF",
  "tradingType": "CASH",
  "coOwners": ["123e4567-e89b-12d3-a456-000000000072"],
  "tenancyType": "JTWROS"
}'
FieldNotes
userIDThe first owner.
accountTypeMust be LIVE.
accountManagementTypeUse a joint value instead of a standard one. See the list below.
tradingTypeThe account's trading type. The example uses CASH.
coOwnersNew. An array with exactly one userID, the second owner. A joint account has exactly two owners.
tenancyTypeNew. The legal rule for what happens to the account if an owner dies. Required.

Joint account management types:

  • JOINT_SELF: self-directed. Both owners trade for themselves.
  • JOINT_ADVISORY: advisory-managed.
  • JOINT_RIA_MANAGED: managed by a Registered Investment Advisor (RIA).

Tenancy types:

  • JTWROS: Joint Tenants with Rights of Survivorship. If one owner dies, the surviving owner receives the whole account.
  • COMMUNITY_PROPERTY: for married owners who live in a community property state. Each spouse owns an equal, undivided share.

Rules

At creation

  • Exactly one co-owner. Zero or more than one is rejected.
  • The co-owner must be a different User from userID.
  • The co-owner must be an individual trader under the same partner. They cannot be deceased or in a blocked status (rejected, revoked, or closed).
  • tenancyType is required and cannot be blank.
  • coOwners and tenancyType only work on joint account types. Sending them on a standard account is rejected.
  • You cannot choose the primary owner. DriveWealth assigns it for tax reporting. It is returned as the read-only primaryOwnerID and is ignored if you send it. DriveWealth may reassign it, for example if an owner's tax residency changes.
  • You cannot convert an existing account to a joint account, or the reverse. Create it as a joint account from the start.

After creation

  • To change tenancyType after the account is created, open a support ticket. Do not change it through the API.
  • You cannot change coOwners. Any update that includes it is rejected.
  • Owners are fixed. You cannot add, remove, or swap an owner. To change owners, close the account and open a new one.

Response

The response looks like a standard account response, with three additions:

  • coOwners: the co-owner on the account.
  • tenancyType: the value you set.
  • primaryOwnerID: read-only. The owner DriveWealth designated as primary.

Retrieve joint accounts

Use the existing account endpoints to retrieve joint accounts:

  • GET /accounts/{accountID} returns that one account, including its joint fields.
  • GET /users/USERID/accounts lists the user's individually owned accounts as well as any joint accounts they are a part of.

Did this page help you?