Calculated Fields

Certain fields on the /v2/licenses and /v2/appointments endpoints are calculated fields. These fields normalize or derive values from state data to provide consistent, standardized outputs.

Renewal Periods

The renewalPeriods object provides calculated dates and renewal type information for a license. This data is derived from the license expiration date and state regulatory requirements.

Example

{
  "renewalPeriods": {
    "renewal": {
      "startDate": "2026-10-02",
      "endDate": "2026-12-31"
    },
    "lateRenewal": {
      "startDate": "2027-01-01",
      "endDate": "2027-12-31"
    },
    "reinstatement": null,
    "renewalType": "RENEWAL_REQUIRED"
  }
}

Fields

Field	Type	Description
`renewal`	object	Start and end dates for the standard renewal window.
`lateRenewal`	object	Start and end dates for late renewal (if applicable).
`reinstatement`	object	Start and end dates for reinstatement (if applicable).
`renewalType`	string	Type of renewal requirement. Possible values: - RENEWAL_REQUIRED - PERPETUAL - NO_RENEWAL_INFORMATION_AVAILABLE

AgentType

The agentType field categorizes a license into one of the following values:

adjuster
producer
travel
surplus

Line of Authority (LOA) Categories

The loaMapping.categories field groups licenses and appointments into normalized lines of authority.

Possible values include:

annuity
casualty
crop
health
life
personal_lines
property
surety
surplus
travel
variable_annuity
variable_life

These normalized categories allow querying across states where license types or LOA names may differ.