Identity API

Page

object

Page metadata for a token-based list response.

sizeinteger(int32)required

Number of items actually returned in this response — equal to items.length. On an empty result this is 0. This is NOT a copy of the request’s page_size hint; clients holding the hint already know what they asked for.

>= 0

Example:25

nextTokenstringrequired

Opaque token to request the next page. null when this is the last page. Pass back as the page_token query parameter to resume.

Example:eyJ2IjoxLCJrIjp7InVwZGF0ZWRBdCI6IjIwMjYtMDUtMTlUMTI6MDA6MDBaIiwiaWQiOiIwMUhYWVoifX0

Example

CreateBankAccountRequest

object
typestringrequired

The type of bank account

Allowed values:SAVINGSCHECKING

Example:CHECKING

holderNamestringrequired

Name of the account holder

Example:Jane Doe

numberstringrequired

Bank account number (4-17 characters)

>= 4 characters<= 17 characters

Example:1234567890

routingNumberstringrequired

Bank routing number (exactly 9 digits)

>= 9 characters<= 9 characters

Example:021000021

bankNamestringrequired

Name of the bank

Example:Chase Bank

nicknamestring

Optional nickname for the bank account

Example:Main

primaryAccountboolean

Whether this should become the owner’s primary bank account. Setting true demotes any existing primary for the same owner. Defaults to false (the owner’s first bank account always becomes primary regardless of this value). null is treated the same as omitted.

Default:false

Example

PolicyType

string

The type of insurance policy

Allowed values:CORPORATIONINDIVIDUALJOINT

Example

InsurancePolicyV2

object
idstring(uuid)requiredread-only

Unique identifier for the insurance policy.

typestringrequired

The type of insurance policy

Allowed values:CORPORATIONINDIVIDUALJOINT

Example:INDIVIDUAL

carrierstringrequired

Name of the insurance carrier.

totalLimitnumber(double)

Maximum coverage limit for the policy.

effectiveOnstring(date)required

Date the insurance policy became effective (YYYY-MM-DD).

expiresOnstring(date)

Date the insurance policy expires (YYYY-MM-DD).

policyNumberstringrequired

Policy number assigned by the carrier.

certificateNumberstringrequired

Certificate number for the policy.

hasFilebooleanread-only

Whether a certificate file has been uploaded for this policy.

certificateUrlstring(uri)read-only

Presigned download URL for the certificate file. Present only when hasFile is true. Expires 10 minutes after the response is generated.

createdAtstring(date-time)requiredread-only

RFC3339 UTC timestamp when the record was created.

updatedAtstring(date-time)requiredread-only

RFC3339 UTC timestamp when the record was last updated.

Example

UpdateInsurancePolicyRequest

object
typestringrequired

The type of insurance policy

Allowed values:CORPORATIONINDIVIDUALJOINT

Example:INDIVIDUAL

carrierstringrequired

Name of the insurance carrier.

Example:Acme Insurance Co.

totalLimitnumber(double)

Maximum coverage limit for the policy.

>= 1<= 10000000

Example:1000000

effectiveOnstring(date)required

Date the insurance policy becomes effective (YYYY-MM-DD).

Example:2024-01-01

expiresOnstring(date)

Date the insurance policy expires (YYYY-MM-DD).

Example:2025-01-01

policyNumberstringrequired

Policy number assigned by the carrier.

Example:POL-001

certificateNumberstringrequired

Certificate number for the policy.

Example:CERT-001

Example