Identity API

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

CreateInsurancePolicyRequest

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

FirmV2

object

Customer-facing firm resource. The FEIN is always masked to ****; the full FEIN is available only via GET /v2/firms/{firmId}/fein (audited).

idstring(uuid)requiredread-only

The unique identifier of the firm.

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

npnstringrequiredread-only

National Producer Number.

Example:1234567

namestring

Legal name of the firm.

Example:Acme Insurance LLC

emailstring(email)

Primary contact email address.

Example:contact@acme.com

typestring

Business entity type (SC, LLC, SP).

Example:LLC

finraCrdNumberstring

FINRA CRD number (digits only, max 11 characters).

Example:12345

feinstringread-only

Masked Federal Employer Identification Number. Always returned as ****. The full FEIN is never exposed by this endpoint.

Example:****6789

testAccountboolean

Whether this is a test account.

createdAtstring(date-time)requiredread-only

ISO-8601 UTC timestamp when the firm was created.

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

updatedAtstring(date-time)read-only

ISO-8601 UTC timestamp of the last update.

Example:2024-06-01T14:22:00Z

Example

FirmV2List

object

Keyset-paginated list of firms (F5 envelope).

itemsarray[object]required

Customer-facing firm resource. The FEIN is always masked to ****; the full FEIN is available only via GET /v2/firms/{firmId}/fein (audited).

Show Child Parameters
pageobjectrequired

Page metadata for a token-based list response.

Show Child Parameters
Example