Fixed
Beneficiary schema corrected to match API behavior
October 16th, 2026
Broker API
The Beneficiary schema on the account endpoints now matches what the API actually accepts and returns.
middle_nameis no longer required and acceptsnull. Omit it or sendnullwhen there is no middle name; an empty string is rejected. Account responses always include the field, usingnullwhen unset.relationshipis limited tospouseandother.typeis limited toprimaryandcontingent. An account with beneficiaries needs at least one primary beneficiary, andshare_pctmust sum to 100 within the primary group and within the contingent group.tax_id_typeis limited toUSA_SSN.tax_idrequires a USA SSN on create and update requests; responses always return the masked valuexxx-xx-xxxx.given_name,family_name, andmiddle_namereject empty strings.date_of_birthis documented as aYYYY-MM-DDdate that cannot be in the future.share_pctis documented as a decimal string greater than 0 and at most 100, with at most two decimal places.
These values were already enforced by the API, so there is no new runtime rejection.
Affected Endpoints
POST /v1/accountsGET /v1/accountsGET /v1/accounts/{account_id}PATCH /v1/accounts/{account_id}