Identity API

AddressType

string

Type of address

Allowed values:MAILINGBUSINESSPHYSICAL

AddressV2

object
idstring(uuid)requiredread-only

Address identifier.

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

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

preferredbooleanrequired

Whether this is the person’s preferred address.

Example:true

createdAtstring(date-time)requiredread-only

RFC3339 UTC timestamp when the address was created.

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

updatedAtstring(date-time)read-only

RFC3339 UTC timestamp when the address was last updated.

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

Example

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