Resolve Address
Geocodes a freeform address string and returns the structured subfields
(street, city, state, county, country, zipCode) in the shape
Field Model V1 rating expects.
Intended as a pre-flight utility: integrators call this before constructing
create/update payloads so addresses include all required pieces (especially
county, which is required for rating but often missing from upstream
systems). Writes are not auto-enriched — this endpoint is read-only.
Strict response contract. If geocoding succeeds but any required
subfield cannot be determined, the endpoint returns a 400 with a
distinct problemCode rather than a partial address. Integrators can
branch on the problemCode to know which field was missing.
zipCode is always returned as a string with leading zeros preserved
(e.g. "02140").
Required permission: company:read
Authorizations
API key authentication. Include your API key in the Authorization header.
Path Parameters
Company identifier
Query Parameters
Freeform address string to geocode. Must be non-empty and non-blank (whitespace-only values are rejected).
1Response
Address resolved successfully into all six subfields
Structured address resolved from a freeform input string. Every field is guaranteed to be populated — the endpoint returns a 400 error rather than a partial address when any subfield (including county) cannot be determined.
Street number and route (e.g. "350 5th Avenue")
City or locality (e.g. "New York")
2-letter state or administrative region code (e.g. "NY")
County or second-order administrative area (e.g. "New York County")
Country name (e.g. "United States")
Postal / zip code as a string. Leading zeros are preserved (e.g. "02140").