AVM
Resolve property AVM by kukun-id or structured address: When kukun-id is provided, the service calls AVM directly. When address fields are provided, the service resolves kukun-id first and then calls AVM.
query Parameters
addressStreet address used to resolve the Kukun property identifier.
cityProperty city used for identity lookup.
stateState the property is located in. Accepts either the two-letter abbreviation or the full state name, case-insensitive (e.g. FL, Florida, or florida) - passed through as-is with no normalization applied.
kukun-idKnown Kukun property identifier. Can be combined with address fields and takes precedence.
zip-codeZIP code used for identity lookup. Accepts 5 digits or ZIP+4 (e.g. 94025 or 94025-1234); the +4 suffix is stripped before the upstream lookup.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
AVM › Responses
Property AVM resolved successfully
successerrorsCondition score (PICO)
Resolve property score by kukun-id or structured address: When kukun-id is provided, the service calls score directly. When address fields are provided, the service resolves kukun-id first and then calls score.
query Parameters
addressStreet address used to resolve the Kukun property identifier.
cityProperty city used for identity lookup.
stateState the property is located in. Accepts either the two-letter abbreviation or the full state name, case-insensitive (e.g. FL, Florida, or florida) - passed through as-is with no normalization applied.
kukun-idKnown Kukun property identifier. Can be combined with address fields and takes precedence.
zip-codeZIP code used for identity lookup. Accepts 5 digits or ZIP+4 (e.g. 94025 or 94025-1234); the +4 suffix is stripped before the upstream lookup.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Condition score (PICO) › Responses
Property score resolved successfully
successerrorsInvestment Outlook (KIO)
When kukun-id is provided, the service calls KIO forecasted-value directly. When address fields are provided, the service resolves kukun-id first and then calls KIO forecasted-value. When only zip-code is provided, the service returns KIO index data without house-specific forecast.
query Parameters
addressStreet address used to resolve the Kukun property identifier.
cityProperty city used for identity lookup.
stateState the property is located in. Accepts either the two-letter abbreviation or the full state name, case-insensitive (e.g. FL, Florida, or florida) - passed through as-is with no normalization applied.
kukun-idKnown Kukun property identifier. Can be combined with address fields and takes precedence.
zip-codeZIP code used for identity lookup. Accepts 5 digits or ZIP+4 (e.g. 94025 or 94025-1234); the +4 suffix is stripped before the upstream lookup.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Investment Outlook (KIO) › Responses
KIO forecast data resolved successfully
successerrorsCommunity Facts
Get property community demographic and health and safety facts: Accepts kukun-id, a complete structured address, or zip-code alone. kukun-id takes precedence when combined with other lookup parameters.
query Parameters
addressStreet address used to resolve the Kukun property identifier.
cityProperty city used for identity lookup.
stateState the property is located in. Accepts either the two-letter abbreviation or the full state name, case-insensitive (e.g. FL, Florida, or florida) - passed through as-is with no normalization applied.
kukun-idKnown Kukun property identifier. Can be combined with address fields and takes precedence.
zip-codeZIP code used for identity lookup. Accepts 5 digits or ZIP+4 (e.g. 94025 or 94025-1234); the +4 suffix is stripped before the upstream lookup.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Community Facts › Responses
Community facts resolved successfully
successerrorsComponent Lifecycle
Resolve property component lifecycle by kukun-id or structured address: When kukun-id is provided, the service calls component lifecycle data directly. When address fields are provided, the service resolves kukun-id first and then calls component lifecycle data.
query Parameters
addressStreet address used to resolve the Kukun property identifier.
cityProperty city used for identity lookup.
stateState the property is located in. Accepts either the two-letter abbreviation or the full state name, case-insensitive (e.g. FL, Florida, or florida) - passed through as-is with no normalization applied.
kukun-idKnown Kukun property identifier. Can be combined with address fields and takes precedence.
zip-codeZIP code used for identity lookup. Accepts 5 digits or ZIP+4 (e.g. 94025 or 94025-1234); the +4 suffix is stripped before the upstream lookup.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Component Lifecycle › Responses
Property component lifecycle resolved successfully
successerrorsProperty Record
Get Property Details (location, structure, public records): Returns location and parcel data, structure characteristics, and tax/assessment/legal records for one property. For valuation, condition score or market outlook, use property_avm, property_condition_score_pico or property_investment_outlook_kio.
query Parameters
addressStreet address used to resolve the Kukun property identifier; trimmed.
cityProperty city used for identity lookup; trimmed.
stateState the property is located in. Accepts either the two-letter abbreviation or the full state name, case-insensitive (e.g. FL, Florida, or florida) - passed through as-is with no normalization applied.
kukun-idKnown Kukun property identifier. Takes precedence over address fields.
zip-codeZIP code used for identity lookup. Accepts 5 digits or ZIP+4 (e.g. 94025 or 94025-1234); the +4 suffix is stripped before the upstream lookup. Surrounding whitespace is removed.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Property Record › Responses
Property details resolved successfully
successerrorsProperty Join
Resolves the property once (kukun-id or structured address) and returns the data of six existing primitives in one response, one section per primitive. Each section equals the standalone endpoint for the same property, with kukun_id and address hoisted to the top level. property-info is load-bearing: if it fails the request fails; any other upstream failure returns its section as null and is listed in metadata.unavailable_sections. Sections excluded by include are absent and listed in metadata.omitted_sections.
query Parameters
addressStreet address used to resolve the Kukun property identifier.
cityProperty city used for identity lookup.
stateState the property is located in. Accepts either the two-letter abbreviation or the full state name, case-insensitive (e.g. FL, Florida, or florida) - passed through as-is with no normalization applied.
permit-limitMaximum number of permits in permits.items, 1-100 (default 25). Ignored when include excludes permits.
includeComma-separated sections to return. Any of property_record, avm, condition_score_pico, investment_outlook_kio, component_lifecycle, permits. Default: all six. Duplicates are collapsed; unknown values return 400.
kukun-idKnown Kukun property identifier. Can be combined with address fields and takes precedence.
zip-codeZIP code used for identity lookup. Accepts 5 digits or ZIP+4 (e.g. 94025 or 94025-1234); the +4 suffix is stripped before the upstream lookup.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Property Join › Responses
Property join resolved successfully