Contracting & Hierarchies API

ProducerDetailV2

A single producer in the calling customer’s organization. Carries the same fields as the list
item plus phones, federatedUsername, and bankAccounts, and serves a live middleName.
Personal and demographic details such as date of birth, SSN, and addresses are not part of a
contracting record and are retrieved from the Identity API.

typestringrequired

The producer kind.

Allowed values:AGENTFIRM

personIdstring(uuid)

The individual’s id (null for firms).

firmIdstring(uuid)

The firm’s id (null for individuals).

firstNamestring

The individual’s first name (null for firms).

middleNamestring

The individual’s middle name (null for firms), read live from the Identity API so it
is current even when the contracting record’s own copy has not caught up.

lastNamestring

The individual’s last name (null for firms).

suffixstring
firmNamestring

The firm’s name (null for individuals).

npnstring

National Producer Number.

emailstring

The individual’s email (null for firms).

organizationIdstring(uuid)
organizationNamestring
roleNamestring
statusIdstring(uuid)
statusNamestring

The human-readable producer status (inlined). Null for firms, which carry no status.

activeboolean

Whether the producer is active. Always true for firms.

divisionsarray[string]
userDefined1string
userDefined2string
userDefined3string
userDefined4string
userDefined5string
userDefined6string
userDefined7string
userDefined8string
userDefined9string
userDefined10string
createdAtstring(date-time)

RFC3339 UTC creation timestamp.

updatedAtstring(date-time)

RFC3339 UTC last-modified timestamp.

bankAccountsarray[object]

A producer’s bank account. The account and routing numbers are masked to ****<last4>.

Show Child Parameters
phonesarray[object]

A producer’s phone number.

Show Child Parameters
federatedUsernamestring

The producer’s federated login username for the calling customer. Null when the
producer has no federated login, and always null for firms.

Example

ProducerPhoneV2

object

A producer’s phone number.

idstring(uuid)
numberstring

Example:5551234567

extensionstring
typestring

The phone kind.

Allowed values:CELLBUSINESSRESIDENTFAX

preferredboolean

Whether this is the producer’s preferred number.

Example

ProducerBankAccountV2

object

A producer’s bank account. The account and routing numbers are masked to ****<last4>.

idstring(uuid)
typestring

The account type.

Allowed values:CHECKINGSAVINGSCREDIT_UNION

bankNamestring
nicknamestring
holderNamestring
numberstring

Account number masked to ****<last4>.

Example:****7890

routingNumberstring

Routing number masked to ****<last4>.

Example:****0021

Example

ContractV2Page

object

A token-paginated page of contracts (plain envelope, no HAL wrappers).

itemsarray[object]required

A contract sent from an agency to a carrier on behalf of a producer.

Show Child Parameters
pageobjectrequired

Pagination metadata for a V2 list response.

Show Child Parameters
Example

UplineContractAssignmentV2

object

Identity of the assignment’s upline, surfaced as part of the caller’s own hierarchy.

idstring(uuid)required

The upline contract assignment id.

displayNumberstring

The upline assignment’s human-readable number.

firmNamestring

The upline’s firm name, if the upline is a firm.

personNamestring

The upline’s person name, if the upline is an individual producer.

Example