Identity API

UpdateAddressRequest

object
typestringrequired

Type of address

Allowed values:MAILINGBUSINESSPHYSICAL

addressLine1stringrequired

First line of the street address.

Example:123 Main St

addressLine2string

Second line of the street address (suite, unit, etc.).

Example:Apt 4B

citystringrequired

City.

Example:Denver

statestringrequired

Two-letter US state code.

Example:CO

zipstringrequired

ZIP code in 5-digit or ZIP+4 format.

Match pattern:^\d{5}(-\d{4})?$

Example:80202

countystring

County name.

Example:Denver

countrystringrequired

Country code (ISO alpha-2).

Example:US

moveInDatestring(date)

Date the person moved to this address (YYYY-MM-DD).

Example:2020-01-15

preferredboolean

Whether this should be the preferred address. When true, any other preferred address for the same person or firm is automatically unset. Omitting or null is treated as false.

Default:false

Example

CreateAddressRequest

object
typestringrequired

Type of address

Allowed values:MAILINGBUSINESSPHYSICAL

addressLine1stringrequired

First line of the street address.

Example:123 Main St

addressLine2string

Second line of the street address (suite, unit, etc.).

Example:Apt 4B

citystringrequired

City.

Example:Denver

statestringrequired

Two-letter US state code.

>= 2 characters<= 2 characters

Example:CO

zipstringrequired

ZIP code in 5-digit or ZIP+4 format.

Match pattern:^\d{5}(-\d{4})?$

Example:80202

countystring

County name.

Example:Denver

countrystringrequired

Country code (ISO alpha-2).

>= 2 characters<= 2 characters

Example:US

moveInDatestring(date)

Date the person moved to this address (YYYY-MM-DD).

Example:2020-01-15

preferredboolean

Whether this should be the person’s preferred address. When the person has no existing addresses, the server sets this to true regardless of the supplied value.

Default:false

Example

PhoneType

string

The type of phone

Allowed values:CELLBUSINESSRESIDENTFAX

Example

PhoneV2

object

A phone record returned by V2 phone endpoints.

idstring(uuid)requiredread-only

Phone identifier.

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

typestringrequired

The type of phone

Allowed values:CELLBUSINESSRESIDENTFAX

Example:CELL

numberstringrequired

10-digit phone number.

Example:3035551234

extensionstring

Optional phone extension.

Example:1234

preferredbooleanrequired

Whether this is the preferred phone number.

Example:true

createdAtstring(date-time)requiredread-only

RFC3339 UTC timestamp when the phone was created.

Example:2024-01-15T10:30:00Z

updatedAtstring(date-time)read-only

RFC3339 UTC timestamp when the phone was last updated.

Example:2024-01-15T14:45:00Z

Example

UpdatePhoneRequest

object
typestringrequired

The type of phone

Allowed values:CELLBUSINESSRESIDENTFAX

Example:CELL

numberstringrequired

Phone number (exactly 10 digits)

Match pattern:^[0-9]{10}$

Example:3035551234

extensionstring

Optional phone extension (max 6 characters)

<= 6 characters

Example:1234

preferredbooleanrequired

Whether this is the preferred phone number

Example:true

Example