Property

AVM

GET

https://api.mykukun.com

/v1/property/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.

AVM › query Parameters

address

string · maxLength: 200

Street address used to resolve the Kukun property identifier.

city

string · maxLength: 120

Property city used for identity lookup.

state

string · maxLength: 200

State 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.

zip-code

string

ZIP code used for identity lookup.

kukun-id

number

Known Kukun property identifier. Can be combined with address fields and takes precedence.

AVM › Headers

Authorization

string · required

The 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

PropertyAvmApiResponseDto

success

boolean · required

PropertyAvmResponseDto · required

errors

required

ApiResponseMetadataDto · required

GET/v1/property/avm

curl --request GET \
  --url https://api.mykukun.com/v1/property/avm \
  --header 'Authorization: <string>'

Example Responses

{
  "success": true,
  "message": {
    "kukun_id": 94473112,
    "address": {
      "formatted": "123 Main St, Kansas City, MO 64113",
      "street_address": "123 Main St",
      "unit_number": null,
      "city": "Kansas City",
      "state": "MO",
      "zip_code": "64113",
      "county": "Jackson",
      "coordinates": {
        "lat": 39.0997,
        "lng": -94.5786
      }
    },
    "property_value": 592173,
    "lower_property_value": 294171,
    "higher_property_value": 792172
  },
  "errors": null,
  "metadata": {
    "responseId": "0123456789abcdef0123456789abcdef",
    "timestamp": "2026-08-11T00:00:00.000Z",
    "version": "v1"
  }
}

json

application/json

Condition score (PICO)

GET

https://api.mykukun.com

/v1/property/score

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.

Condition score (PICO) › query Parameters

address

string · maxLength: 200

Street address used to resolve the Kukun property identifier.

city

string · maxLength: 120

Property city used for identity lookup.

state

string · maxLength: 200

zip-code

string

ZIP code used for identity lookup.

kukun-id

number

Known Kukun property identifier. Can be combined with address fields and takes precedence.

Condition score (PICO) › Headers

Authorization

string · required

The 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

PropertyScoreApiResponseDto

success

boolean · required

PropertyScoreResponseDto · required

errors

required

ApiResponseMetadataDto · required

GET/v1/property/score

curl --request GET \
  --url https://api.mykukun.com/v1/property/score \
  --header 'Authorization: <string>'

Example Responses

{
  "success": true,
  "message": {
    "kukun_id": 94473112,
    "address": {
      "formatted": "123 Main St, Kansas City, MO 64113",
      "street_address": "123 Main St",
      "unit_number": null,
      "city": "Kansas City",
      "state": "MO",
      "zip_code": "64113",
      "county": "Jackson",
      "coordinates": {
        "lat": 39.0997,
        "lng": -94.5786
      }
    },
    "property_score": 819,
    "neighborhood_score": 638
  },
  "errors": null,
  "metadata": {
    "responseId": "0123456789abcdef0123456789abcdef",
    "timestamp": "2026-08-11T00:00:00.000Z",
    "version": "v1"
  }
}

json

application/json

Investment Outlook (KIO)

GET

https://api.mykukun.com

/v1/property/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.

Investment Outlook (KIO) › query Parameters

address

string · maxLength: 200

Street address used to resolve the Kukun property identifier.

city

string · maxLength: 120

Property city used for identity lookup.

state

string · maxLength: 200

zip-code

string

ZIP code used for identity lookup.

kukun-id

number

Known Kukun property identifier. Can be combined with address fields and takes precedence.

Investment Outlook (KIO) › Headers

Authorization

string · required

The 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

PropertyKioApiResponseDto

success

boolean · required

PropertyKioResponseDto · required

errors

required

ApiResponseMetadataDto · required

GET/v1/property/kio

curl --request GET \
  --url https://api.mykukun.com/v1/property/kio \
  --header 'Authorization: <string>'

Example Responses

{
  "success": true,
  "message": {
    "kukun_id": 94473112,
    "address": {
      "formatted": "123 Main St, Kansas City, MO 64113",
      "street_address": "123 Main St",
      "unit_number": null,
      "city": "Kansas City",
      "state": "MO",
      "zip_code": "64113",
      "county": "Jackson",
      "coordinates": {
        "lat": 39.0997,
        "lng": -94.5786
      }
    },
    "kio_id": 94025,
    "zip_code": 94025,
    "current_forecast_date": "2026-07-16",
    "current_forecast": 14.78363,
    "forecast_1": 14.81635843,
    "forecast_2": 14.85470737,
    "forecast_3": 14.89547871,
    "forecast_4": 14.94305338,
    "forecast_5": 14.9946252,
    "growth_percent_1": 0.2213829168,
    "growth_percent_2": 0.2588283549,
    "growth_percent_3": 0.2744674593,
    "growth_percent_4": 0.3193900347,
    "growth_percent_5": 0.3451223508,
    "five_year_growth": 1.4272218508,
    "statistical_error_range_from": 0,
    "statistical_error_range_to": 0,
    "msa_average": 0,
    "county_average": 0,
    "state_average": 0,
    "national_average": 2.0835030136,
    "cbsa_code": 41860,
    "cbsa_name": "San Francisco-Oakland-Berkeley, CA Metro Area",
    "county": "San Mateo County",
    "county_code": 6081,
    "forecast_value_5yr": 5454050.05767236
  },
  "errors": null,
  "metadata": {
    "responseId": "0123456789abcdef0123456789abcdef",
    "timestamp": "2026-08-11T00:00:00.000Z",
    "version": "v1"
  }
}

json

application/json

Community Facts

GET

https://api.mykukun.com

/v1/property/community-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.

Community Facts › query Parameters

address

string · maxLength: 200

Street address used to resolve the Kukun property identifier.

city

string · maxLength: 120

Property city used for identity lookup.

state

string · maxLength: 200

zip-code

string

ZIP code used for identity lookup.

kukun-id

number

Known Kukun property identifier. Can be combined with address fields and takes precedence.

Community Facts › Headers

Authorization

string · required

The 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

PropertyCommunityFactsResponseDto

kukun_id

number | null · required

object · required

zip_code

string | null · required

CommunityDto · required

DemographicsDto · required

LivabilityDto · required

EnvironmentDto · required

CrimeDto · required

NaturalHazardsDto · required

GET/v1/property/community-facts

curl --request GET \
  --url https://api.mykukun.com/v1/property/community-facts \
  --header 'Authorization: <string>'

Example Responses

{
  "success": true,
  "message": {
    "kukun_id": 94473112,
    "address": {
      "formatted": "123 Main St, Kansas City, MO 64113",
      "street_address": "123 Main St",
      "unit_number": null,
      "city": "Kansas City",
      "state": "MO",
      "zip_code": "64113",
      "county": "Jackson",
      "coordinates": {
        "lat": 39.0997,
        "lng": -94.5786
      }
    },
    "zip_code": "64113",
    "community": {
      "city": "Kansas City",
      "state": "MO",
      "county": "Jackson County",
      "timezone": "America/Chicago",
      "area_code": 816
    },
    "demographics": {
      "population_count": 40526,
      "total_male_population": 19730,
      "total_female_population": 20796,
      "housing_count": 16271,
      "age_distribution": {
        "age_under_10": 6110,
        "age_10_to_19": 4434,
        "age_20_to_29": 4390,
        "age_30_to_39": 6057,
        "age_40_to_49": 6465,
        "age_50_to_69": 8998,
        "age_70_plus": 4072
      }
    },
    "livability": {
      "walk_score": 90,
      "walk_percentile": 90,
      "bike_score": 91,
      "bike_percentile": 92,
      "transit_score": 46,
      "transit_percentile": 46
    },
    "environment": {
      "air_quality_score": 36,
      "air_quality_percentile": 69
    },
    "crime": {
      "property_crime_score": 27,
      "property_crime_percentile": 30,
      "other_crime_score": 20,
      "other_crime_percentile": 23
    },
    "natural_hazards": {
      "overall_score": 40,
      "overall_percentile": 64,
      "base_score": 2,
      "by_type": {
        "wildfire": 5,
        "earthquake": 5,
        "flood": 5,
        "volcano": 0,
        "snowfall": 1,
        "drought": 1,
        "landslide": 3,
        "hurricane": 0,
        "tornado": 1,
        "heatwave": 1,
        "avalanche": 0
      }
    }
  },
  "errors": null,
  "metadata": {
    "responseId": "0123456789abcdef0123456789abcdef",
    "timestamp": "2026-08-11T00:00:00.000Z",
    "version": "v1"
  }
}

json

application/json

Component Lifecycle

GET

https://api.mykukun.com

/v1/property/component-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.

Component Lifecycle › query Parameters

address

string · maxLength: 200

Street address used to resolve the Kukun property identifier.

city

string · maxLength: 120

Property city used for identity lookup.

state

string · maxLength: 200

zip-code

string

ZIP code used for identity lookup.

kukun-id

number

Known Kukun property identifier. Can be combined with address fields and takes precedence.

Component Lifecycle › Headers

Authorization

string · required

The 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

PropertyComponentLifecycleApiResponseDto

success

boolean · required

PropertyComponentLifecycleResponseDto · required

errors

required

ApiResponseMetadataDto · required

GET/v1/property/component-lifecycle

curl --request GET \
  --url https://api.mykukun.com/v1/property/component-lifecycle \
  --header 'Authorization: <string>'

Example Responses

{
  "success": true,
  "message": {
    "kukun_id": 77605190,
    "address": {
      "formatted": "1060 Continental Dr, Menlo Park, CA 94025",
      "street_address": "1060 Continental Dr",
      "unit_number": null,
      "city": "Menlo Park",
      "state": "CA",
      "zip_code": "94025",
      "county": "San Mateo",
      "coordinates": {
        "lat": 37.429358,
        "lng": -122.211643
      }
    },
    "items": [
      {
        "item_id": 14,
        "item_name": "Interior paint",
        "category": "interior_finishes",
        "depreciation_value": 12026,
        "remaining_useful_life_years": 11
      },
      {
        "item_id": 13,
        "item_name": "Exterior paint",
        "category": "envelope",
        "depreciation_value": 11053,
        "remaining_useful_life_years": 11
      },
      {
        "item_id": 12,
        "item_name": "Heating and/or AC",
        "category": "systems",
        "depreciation_value": 9019,
        "remaining_useful_life_years": 11
      },
      {
        "item_id": 10,
        "item_name": "Flooring",
        "category": "interior_finishes",
        "depreciation_value": 7688,
        "remaining_useful_life_years": 16
      },
      {
        "item_id": 15,
        "item_name": "Landscape & Hardscape",
        "category": "site",
        "depreciation_value": 17180,
        "remaining_useful_life_years": 31
      },
      {
        "item_id": 3,
        "item_name": "Kitchen",
        "category": "rooms",
        "depreciation_value": 14957,
        "remaining_useful_life_years": 31
      },
      {
        "item_id": 9,
        "item_name": "Windows",
        "category": "envelope",
        "depreciation_value": 7688,
        "remaining_useful_life_years": 31
      },
      {
        "item_id": 4,
        "item_name": "Master Bathroom",
        "category": "rooms",
        "depreciation_value": 7129,
        "remaining_useful_life_years": 31
      },
      {
        "item_id": 5,
        "item_name": "Bathroom #1",
        "category": "rooms",
        "depreciation_value": 3495,
        "remaining_useful_life_years": 31
      },
      {
        "item_id": 6,
        "item_name": "Bathroom #2",
        "category": "rooms",
        "depreciation_value": 3075,
        "remaining_useful_life_years": 31
      },
      {
        "item_id": 16,
        "item_name": "Half Bathroom",
        "category": "rooms",
        "depreciation_value": 2796,
        "remaining_useful_life_years": 31
      },
      {
        "item_id": 11,
        "item_name": "Roof",
        "category": "envelope",
        "depreciation_value": 5591,
        "remaining_useful_life_years": 36
      },
      {
        "item_id": 1,
        "item_name": "Foundation & Structure",
        "category": "structure",
        "depreciation_value": 29062,
        "remaining_useful_life_years": 71
      },
      {
        "item_id": 2,
        "item_name": "Down to Studs",
        "category": "systems",
        "depreciation_value": 11024,
        "remaining_useful_life_years": 71
      }
    ]
  },
  "errors": null,
  "metadata": {
    "responseId": "0123456789abcdef0123456789abcdef",
    "timestamp": "2026-08-11T00:00:00.000Z",
    "version": "v1"
  }
}

json

application/json

Property Record

GET

https://api.mykukun.com

/v1/property/details

Get Property Details (location, structure, public records, AVM, scores, KIO): Resolves a kukunId (directly or via address lookup) and fans out to all internal data sources in parallel. Returns location and parcel data, structure characteristics, tax/assessment/legal records, AVM valuation, Property/Neighborhood Scores, and KIO market-outlook forecast in a single response.

Property Record › query Parameters

address

string · maxLength: 200

Street address used to resolve the Kukun property identifier; trimmed.

city

string · maxLength: 120

Property city used for identity lookup; trimmed.

state

string · maxLength: 200

State value for identity lookup; surrounding whitespace is removed.

zip-code

string

ZIP code used for identity lookup; surrounding whitespace is removed.

kukun-id

number

Known Kukun property identifier. Takes precedence over address fields.

Property Record › Headers

Authorization

string · required

The 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

PropertyDetailsApiResponseDto

success

boolean · required

PropertyDetailsResponseDto · required

errors

required

object · required

GET/v1/property/details

curl --request GET \
  --url https://api.mykukun.com/v1/property/details \
  --header 'Authorization: <string>'

Example Responses

{
  "success": true,
  "message": {
    "kukun_id": 94473112,
    "location": {
      "full_address": "123 Main St, Kansas City, MO 64113",
      "street_number": "123",
      "street_direction_left": null,
      "street": "Main",
      "suffix": "St",
      "street_direction_right": null,
      "unit_number": null,
      "unit_type": null,
      "city": "Kansas City",
      "state": "MO",
      "county": "Jackson",
      "county_code": "09095",
      "zip_code": 64113,
      "display_zip_code": "64113",
      "zip4": 1234,
      "coordinates": {
        "lat": 39.0997,
        "lng": -94.5786
      },
      "geolocation_quality_code": "0",
      "property_type": "Single Family Residence",
      "fips": 9095,
      "parcel_number": "32-765-03-01-00-0-00-000",
      "subdivision": "DOWNTOWN",
      "school_district": "KANSAS CITY PUBLIC SCHOOLS"
    },
    "structure": {
      "year_built": 1965,
      "approximate_age": 58,
      "bedrooms": 6,
      "bathrooms": 3,
      "partial_bathrooms": 0,
      "total_rooms": 9,
      "living_area": 3150,
      "land_area": 13824,
      "land_area_acre": 0.317,
      "building_area": 3150,
      "pool": true,
      "garage": "Carport",
      "garage_parking_spaces": 2,
      "waterfront": false,
      "structure_type": "Ranch Rambler",
      "basement": false,
      "basement_area": 0,
      "roof_type": null,
      "exterior_walls_type": null,
      "heating_type": "Central",
      "fireplace": false,
      "air_conditioning_type": "Refrigeration",
      "no_of_units": 0,
      "floors": 0,
      "flood_zone": null
    },
    "public_records": {
      "assessed_land_value": 1523220,
      "assessed_improvement_value": 736127,
      "assessed_value": 2259347,
      "assessed_year": 2021,
      "assessed_market_value": 0,
      "tax_amount": 26756.54,
      "tax_year": 2021,
      "deed_type": null,
      "public_records_property_id": null,
      "carrier_route": "C064",
      "census_tract_number": "613000",
      "census_block_number": "1004",
      "census_place": "0608161",
      "census_place_number": "08161",
      "census_block_group": "060816130001",
      "census_block_group_number": "1",
      "legal_description": "LOT 166 SHARON HEIGHTS UNIT NO 11 RSM 60/25 26",
      "owner_name": "HOWERY RAF; KHABBAZ LIN",
      "owner_occupied": true,
      "first_loan_lender_name": null
    },
    "valuation": {
      "property_value": 1198125,
      "lower_property_value": 923597,
      "higher_property_value": 1566307
    },
    "scores": {
      "property_score": 649,
      "neighborhood_score": 645
    },
    "market_outlook": {
      "kio_id": 94025,
      "current_forecast_date": "2026-07-16",
      "current_forecast": 14.78363,
      "forecast_1": 14.81635843,
      "forecast_2": 14.85470737,
      "forecast_3": 14.89547871,
      "forecast_4": 14.94305338,
      "forecast_5": 14.9946252,
      "growth_percent_1": 0.2213829168,
      "growth_percent_2": 0.2588283549,
      "growth_percent_3": 0.2744674593,
      "growth_percent_4": 0.3193900347,
      "growth_percent_5": 0.3451223508,
      "five_year_growth": 1.4272218508,
      "statistical_error_range_from": 0,
      "statistical_error_range_to": 0,
      "msa_average": 0,
      "county_average": 0,
      "state_average": 0,
      "national_average": 2.0835030136,
      "cbsa_code": 41860,
      "cbsa_name": "San Francisco-Oakland-Berkeley, CA Metro Area",
      "forecast_value_5yr": 5454050.05767236
    }
  },
  "errors": null,
  "metadata": {
    "responseId": "0123456789abcdef0123456789abcdef",
    "timestamp": "2026-08-11T00:00:00.000Z",
    "version": "v1",
    "partial": false
  }
}

json

application/json

Permits

AVM

GET

https://api.mykukun.com

/v1/property/avm

AVM › query Parameters

address

string · maxLength: 200

Street address used to resolve the Kukun property identifier.

city

string · maxLength: 120

Property city used for identity lookup.

state

string · maxLength: 200

zip-code

string

ZIP code used for identity lookup.

kukun-id

number

Known Kukun property identifier. Can be combined with address fields and takes precedence.

AVM › Headers

Authorization

string · required

The 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

PropertyAvmApiResponseDto

success

boolean · required

PropertyAvmResponseDto · required

errors

required

ApiResponseMetadataDto · required

Condition score (PICO)

GET

https://api.mykukun.com

/v1/property/score

Condition score (PICO) › query Parameters

address

string · maxLength: 200

Street address used to resolve the Kukun property identifier.

city

string · maxLength: 120

Property city used for identity lookup.

state

string · maxLength: 200

zip-code

string

ZIP code used for identity lookup.

kukun-id

number

Known Kukun property identifier. Can be combined with address fields and takes precedence.

Condition score (PICO) › Headers

Authorization

string · required

The 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

PropertyScoreApiResponseDto

success

boolean · required

PropertyScoreResponseDto · required

errors

required

ApiResponseMetadataDto · required

Investment Outlook (KIO)

GET

https://api.mykukun.com

/v1/property/kio

Investment Outlook (KIO) › query Parameters

address

string · maxLength: 200

Street address used to resolve the Kukun property identifier.

city

string · maxLength: 120

Property city used for identity lookup.

state

string · maxLength: 200

zip-code

string

ZIP code used for identity lookup.

kukun-id

number

Known Kukun property identifier. Can be combined with address fields and takes precedence.

Investment Outlook (KIO) › Headers

Authorization

string · required

The 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

PropertyKioApiResponseDto

success

boolean · required

PropertyKioResponseDto · required

errors

required

ApiResponseMetadataDto · required

Community Facts

GET

https://api.mykukun.com

/v1/property/community-facts

Community Facts › query Parameters

address

string · maxLength: 200

Street address used to resolve the Kukun property identifier.

city

string · maxLength: 120

Property city used for identity lookup.

state

string · maxLength: 200

zip-code

string

ZIP code used for identity lookup.

kukun-id

number

Known Kukun property identifier. Can be combined with address fields and takes precedence.

Community Facts › Headers

Authorization

string · required

The 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

PropertyCommunityFactsResponseDto

kukun_id

number | null · required

object · required

zip_code

string | null · required

CommunityDto · required

DemographicsDto · required

LivabilityDto · required

EnvironmentDto · required

CrimeDto · required

NaturalHazardsDto · required

Component Lifecycle

GET

https://api.mykukun.com

/v1/property/component-lifecycle

Component Lifecycle › query Parameters

address

string · maxLength: 200

Street address used to resolve the Kukun property identifier.

city

string · maxLength: 120

Property city used for identity lookup.

state

string · maxLength: 200

zip-code

string

ZIP code used for identity lookup.

kukun-id

number

Known Kukun property identifier. Can be combined with address fields and takes precedence.

Component Lifecycle › Headers

Authorization

string · required

The 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

PropertyComponentLifecycleApiResponseDto

success

boolean · required

PropertyComponentLifecycleResponseDto · required

errors

required

ApiResponseMetadataDto · required

Property Record

GET

https://api.mykukun.com

/v1/property/details

Property Record › query Parameters

address

string · maxLength: 200

Street address used to resolve the Kukun property identifier; trimmed.

city

string · maxLength: 120

Property city used for identity lookup; trimmed.

state

string · maxLength: 200

State value for identity lookup; surrounding whitespace is removed.

zip-code

string

ZIP code used for identity lookup; surrounding whitespace is removed.

kukun-id

number

Known Kukun property identifier. Takes precedence over address fields.

Property Record › Headers

Authorization

string · required

The 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

PropertyDetailsApiResponseDto

success

boolean · required

PropertyDetailsResponseDto · required

errors

required

object · required