Contracting & Hierarchies API

HierarchyNodeV2Page

object

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

itemsarray[object]required

A node in an organization’s contract-assignment hierarchy, decoupled from the internal
Contracting domain models. The node key is contractAssignmentId; uplineContractAssignmentId
links to the parent node and is null on root nodes. Reference names are inlined next to
their ids. active is computed over the tree — a node is inactive when its own status is
inactive or any node above it is. A node represents either an individual (type = AGENT,
identified by personId) or a firm (type = FIRM, identified by firmId); the
identifier that does not apply to the node’s kind is null.

Show Child Parameters
pageobjectrequired

Pagination metadata for a V2 list response.

Show Child Parameters
Example

PageInfo

object

Pagination metadata for a V2 list response.

sizeintegerrequired

Number of items returned in this response (equal to items.length).

nextTokenstring | nullrequired

Opaque continuation token for the next page, or null on the last page.

Example

ApiError

object

The AgentSync error shape.

messagestringrequired

A human-readable description of the error.

detailsarray[object]

Optional field-level details.

Show Child Parameters
Example

WebhookEventEnvelope

object

Common wrapper present on every outbound webhook event. The data field
is polymorphic; its schema depends on the value of type.

idstringrequired

Globally unique event identifier. Uses the TypeID format with the
prefix whe_ followed by a UUIDv7-derived suffix
(e.g. whe_01j8e4k2abc123def456). Use this field to deduplicate
deliveries if your endpoint receives the same event more than once.

Example:whe_01j8e4k2abc123def456

typestringrequired

Dot-notation event type string. Use this field to route the event to
the appropriate handler in your integration.

Allowed values:contract.producer_status.updatedcontract.assignment.updatedcontract.assignment.deletedcontract.assignment_change.updatedcontract.assignment_change.deletedcontract.packet.submittedcontract.updatedcontract.deletedcontract.responsible_party.updatedhierarchy.producer.addedhierarchy.producer.changedhierarchy.producer.relationship.terminated

Example:contract.assignment.updated

Example

ProducerStatusUpdatedData

object

Payload for the contract.producer_status.updated event.

producerIdstring(uuid)required

The unique identifier of the producer.

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

npnstring | null

The National Producer Number of the producer.

Example:1234567

organizationIdstring(uuid)required

The unique identifier of the organization which the producer’s role and status has been updated for.

Example:660e8400-e29b-41d4-a716-446655440001

organizationNamestringrequired

The name of the organization which the producer’s role and status has been updated for.

Example:Acme Insurance Agency

startDatestring(date)required

The date of when the producer started with their organization. Format: yyyy-MM-dd

Example:2023-01-15

endDatestring | null(date)

The date of when the producer ended with their organization. Format: yyyy-MM-dd

statusIdstring(uuid)required

The unique identifier of the status of the producer.

Example:770e8400-e29b-41d4-a716-446655440002

statusNamestringrequired

The name of the status of the producer.

Example:Active

activebooleanrequired

Denotes if the producer is currently active with their organization.

Example:true

updatedAtstring | null(date-time)

Timestamp of when this record was last updated. Format: yyyy-MM-dd’T’HH:mm:ss’Z’

Example:2024-06-20T14:45:00Z

hireDatestring | null(date)

The date the producer was hired by their organization. Format: yyyy-MM-dd

Example:2023-01-15

Example