Identity API

UpdatePersonRequest

object

Fields to apply to a person. Only non-null fields are applied — omitted or null fields leave the stored value untouched (partial update). firstName and lastName are required.

firstNamestringrequired

Example:Grace

lastNamestringrequired

Example:Hopper

middleNamestring
preferredFirstNamestring

<= 100 characters

titlestring

The person’s honorific title.

Allowed values:DRMRMRSMSMISS

Example:MS

suffixstring

The person’s name suffix.

Allowed values:JRSRIIIIIIOBEMBEBSCJPGM

Example:JR

dateOfBirthstring(date)
genderstring

The person’s gender.

Allowed values:MALEFEMALE

Example:FEMALE

primaryEmailstring(email)
secondaryEmailstring(email)
citizenshipCountrystring
residentStatestring
unitedStatesCitizenboolean
unitedStatesWorkAuthorizedboolean
marriedboolean
npnstring

National Producer Number. Must start with a non-zero digit and contain only digits.

Match pattern:^[1-9][0-9]*$

<= 12 characters

finraCrdNumberstring

FINRA CRD number. Must contain only digits.

Match pattern:^[0-9]+$

<= 11 characters

ssnstring

Social Security Number. Must be exactly 9 digits.

Match pattern:^[0-9]*$

>= 9 characters<= 9 characters

Example

SsnResponse

object

Carries a person’s full, unmasked Social Security Number. Returned only by GET /v2/persons/{personId}/ssn; the SSN is masked in all other responses.

personIdstring(uuid)requiredread-only

The unique identifier of the person.

Example:550e8400-e29b-41d4-a716-446655440000

ssnstringrequiredread-only

The full, unmasked Social Security Number (9 digits).

Example:123456789

Example

AssociateFirmRequestV2

object

Identifies the existing firm to associate with the person, and optionally the person’s role in it.

firmIdstring(uuid)required

The unique identifier of the firm to associate.

Example:550e8400-e29b-41d4-a716-446655440000

rolestring

The person’s role in the firm. Defaults to PRINCIPAL when omitted.

Allowed values:PRINCIPALAGENT_FIRM_MANAGERAGENT

Default:PRINCIPAL

Example:PRINCIPAL

Example

PersonFirmV2

object

An association between a person and a firm.

personIdstring(uuid)requiredread-only

The unique identifier of the associated person.

Example:550e8400-e29b-41d4-a716-446655440000

firmIdstring(uuid)requiredread-only

The unique identifier of the associated firm.

Example:660e8400-e29b-41d4-a716-446655440111

rolestringrequired

The person’s role in the firm.

Allowed values:PRINCIPALAGENT_FIRM_MANAGERAGENT

Example:PRINCIPAL

Example

AddressType

string

Type of address

Allowed values:MAILINGBUSINESSPHYSICAL