> ## Documentation Index
> Fetch the complete documentation index at: https://develop.cotality.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Property characteristics
> Retrieve granular land, structure, and ownership data across the United States — for collateral valuations, underwriting checks, and hazard risk profiles.
Retrieve granular land, structure, and ownership data across the United States. Use this tool to perform collateral valuations, automate underwriting checks, and assess hazard risk profiles for any residential or commercial property.
```mermaid theme={null}
graph LR
A[Address / CLIP input] --> B[Property characteristics tool]
B --> C[Land attributes]
B --> D[Structure specs]
B --> E[Ownership details]
C & D & E --> F[MISMO / ACORD standard output]
```
Once you have one or more CLIPs from the [CLIP tools](/mcp/property-data/tools/clip-tools), pass them here to retrieve the full characteristics profile for each property.
***
## Industry solutions and use cases
This tool is designed to support specific persona workflows. Choose your path to understand how property data maps to your business outcomes:
**Automate valuation and collateral review**
* **Comparable matching** — Filter properties using `livingSquareFootage` and `actualYearBuilt` to locate geographic comparables for appraisal reviews
* **MISMO compliance** — Ensure structural characteristics align with FHFA appraisal datasets and MISMO v3.x container mappings
* **Accessory units** — Iterate through the `structure` array to identify multiple structures (ADUs, guest houses) on the parcel using `buildingSequenceNumber`
[See the full mortgage and valuation solutions guide →](/solutions/mortgage-valuation)
**Evaluate structure vulnerability**
* **Building classification** — Assess construction materials using `buildingClassificationCode` (Fireproof Steel vs. Wood Frame) and `universalExternalWallCode` to determine replacement costs
* **Roof characteristics** — Analyze `universalRoofCode` (Gable, Flat) and `universalRoofCoverCode` (Clay Tile, Aluminum, Shake) to price hazard policies
* **Basement exposure** — Review `universalBasementCode` and `basementSquareFootage` to price flood and sewer backup riders
[See the full property insurance solutions guide →](/solutions/property-insurance)
**Search and screen properties**
* **Investment screening** — Combine `landDimensionAcresTotal` with `summaryNumberOfBedrooms` and `totalNumberOfBathrooms` to filter opportunities
* **Assessment data** — Analyze tax valuation histories via `universalTotalValue` and verify tax rates across local county jurisdictions
[See the full brokerage and investing solutions guide →](/solutions/brokerage-investing)
***
## Industry standards alignment
Cotality property data conforms to the dominant industry standards used across mortgage, insurance, and real estate:
* **MISMO residential XML (v3.x)** — The nested `structure` elements map directly to the `VALUATION_RESPONSE/VALUATION_ANALYSIS/PROPERTY/STRUCTURE` container. `livingSquareFootage` maps to MISMO's `GrossLivingAreaSquareFeet` attribute
* **ACORD P\&C standards** — `universalConstructionTypeCode` maps to the ACORD `ConstructionCode` standard; `universalExternalWallCode` and `universalRoofCoverCode` map to ACORD structural rating standards for risk underwriting
* **USPS publication 28** — Address fields (`streetNamePrefixDirection`, `streetNameSuffix`, `unitType`) are pre-standardized using USPS postal addressing standards
* **OGC well-known text (WKT)** — Building footprint geometry in the `footprint` object is returned in WKT format, compatible with ArcGIS, QGIS, PostGIS, and Leaflet
***
## AI agent onboarding guidelines
When integrating this tool into LLM-powered agents or AI workflows, configure your agent's system instructions with the following rules:
**Address fuzzy matching** — If a user queries by address, always invoke `clip-find_property_by_full_address` first. Use the returned `clip` to call `pc-characteristics_by_clips_tool`.
**Structure loop** — Parcels can contain multiple structures. If the user asks about "the building," check whether `summaryNumberOfBuildings > 1`. If so, iterate through the `structure` array and ask the user to clarify which building sequence they want.
**Modeled vs. recorded data** — Check `yearBuiltModeledIndicator` before responding. If it is `1`, state that the construction year is a **statistical estimate**, not a county record.
***
## `pc-characteristics_by_clips_tool`
Retrieve comprehensive property characteristics data from Cotality for residential and commercial properties using CLIP identifiers.
**When to use:**
* You need detailed land, structure, or attribute data for one or more properties
* Performing property valuation or appraisal workflows
* Conducting real estate market analysis or comparables research
* Looking up owner information, tax assessments, or zoning details
* Verifying building specifications, construction details, or amenities
**Examples:**
* *"Compare characteristics of properties with CLIPs 111111111 and 222222222"*
* *"Find building square footage and year built for CLIP 555555555"*
* *"Retrieve owner information and land use for CLIP 999999999"*
### Input schema
| Parameter | Type | Required | Description |
| --------- | --------------- | -------- | --------------------------------------------------------- |
| `clips` | `array[string]` | Yes | A list of Cotality CLIP (Parcel Level Identifier) numbers |
Each CLIP must be a non-empty string consisting only of numeric characters (e.g. `["123456789", "987654321"]`). The tool supports batch queries with multiple CLIPs.
### Example request
```json theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "pc-characteristics_by_clips_tool",
"arguments": {
"clips": ["123456789"]
}
}
}
```
### Output schema
The response contains a standard envelope wrapping an array of `Property` objects. See [Response envelope](#response-envelope) and the field references below.
***
## Response envelope
| Field | Type | Description |
| ---------- | ----------------- | ------------------------------------------ |
| `success` | `boolean` | Whether the request completed successfully |
| `data` | `array[Property]` | Array of property records |
| `count` | `integer` | Number of records in `data` |
| `messages` | `array[string]` | Informational or warning messages |
All four fields are **always present** in every response.
***
## Property object
Each object in the `data` array is a `Property` record. Both fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ------------------------- | ------------------------- | ---------------------------------------------------------------------- |
| `clip` | `string` | Cotality CLIP identifier for the property |
| `propertyCharacteristics` | `PropertyCharacteristics` | Nested object containing `land`, `structure`, and `propertyAttributes` |
### PropertyCharacteristics
All three fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| -------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `land` | `Land` | Land-level data (see [Land fields](#land-fields)) |
| `structure` | `array[Structure]` | Array of structure records — one per building on the parcel (see [Structure fields](#structure-fields)) |
| `propertyAttributes` | `PropertyAttributes` | Ownership, location, utilities, and feature data (see [Property attributes fields](#property-attributes-fields)) |
***
## Land fields
The `land` object contains parcel-level information including dimensions, land use, legal descriptions, and assessed values. All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ------------------------------------ | ----------------------- | ------------------------------------------------------------------------------------------ |
| `landDimensionAcresTotal` | `number or string` | Total acreage of the parcel (CoreLogic derived or county provided) |
| `landDimensionSquareFeetTotal` | `number or string` | Total land mass in square feet |
| `landDimensionAcres` | `number or string` | *(Deprecated)* Total acreage of the parcel |
| `landDimensionSquareFeet` | `number or string` | *(Deprecated)* Total land mass in square feet |
| `landUseCode` | `string` | CoreLogic standardized land use code |
| `landUseCodeDescription` | `string` | Description of the `landUseCode` |
| `propertyIndicatorCode` | `string` | General property type code (e.g. Single Family Residence, Condominium, Commercial) |
| `propertyIndicatorCodeDescription` | `string` | Description of the `propertyIndicatorCode` |
| `landUseStateCode` | `string` | State-level land use code |
| `landUseStateCodeDescription` | `string` | Description of the `landUseStateCode` |
| `landUseCountyCode` | `string` | County-level land use code |
| `landUseCountyCodeDescription` | `string` | Description of the `landUseCountyCode` |
| `legalBlockIdentification` | `string` | County block number where the parcel is located |
| `legalBlockSuffix` | `string` | County block number suffix |
| `standardSubdivisionCode` | `string` | Subdivision or condominium name (e.g. "Highland Mills Estates") |
| `standardSubdivisionCodeDescription` | `string` | Description of the `standardSubdivisionCode` |
| `subdivisionTractNumber` | `string` | Unique number assigned to a specific subdivision by the county |
| `universalTotalValue` | `integer` | Total assessed value (Land + Improvement) used by the local taxing authority |
| `universalTotalValueSourceIndicator` | `string` | Source type for the total value: A = Assessed, M = Market, P = Appraised, T = Transitional |
| `lot` | `array[Lot]` | Lot-level legal descriptions (see [Lot](#lot)) |
| `landDimension` | `array[LandDimension]` | Detailed lot dimensions (see [LandDimension](#landdimension)) |
| `topography` | `array[LandTopography]` | Topography codes (see [LandTopography](#landtopography)) |
### Lot
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| -------------------------- | --------- | ----------------------------------------------------------------- |
| `legalLotIdentification` | `string` | Subdivision or county map lot number |
| `lotSuffixCode` | `string` | Lot number suffix |
| `lotSuffixCodeDescription` | `string` | Legal description providing additional lot boundary details |
| `lotSequenceNumber` | `integer` | Sequence number identifying the lot within a parcel (starts at 1) |
### LandDimension
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ---------------------------------- | ------------------ | ------------------------------------------------------------- |
| `landDimensionSquareFeet` | `number or string` | Area of lot in square feet suitable for building construction |
| `landDimensionDepth` | `number or string` | Linear feet between the front and back of the lot |
| `landDimensionFront` | `number or string` | Linear feet across the front of the lot facing the street |
| `landDimensionSequence` | `integer` | Processing sequence number (starts at 1) |
| `landDimensionTypeCode` | `string` | Lot shape code (e.g. "IRR" = Irregular) |
| `landDimensionTypeCodeDescription` | `string` | Description of the lot shape code |
### LandTopography
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ------------------------------------ | -------- | -------------------------------------- |
| `universalTopographyCode` | `string` | CoreLogic standardized topography code |
| `universalTopographyCodeDescription` | `string` | Description of the topography code |
***
## Structure fields
The `structure` array contains one record per building on the parcel. Each `Structure` object carries top-level building attributes and several nested detail objects. All fields are optional, nullable, and default to `null`.
### Top-level structure fields
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ----------------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `structureId` | `string` | Unique structure identifier |
| `actualYearBuilt` | `integer` | Original construction year (format: YYYY) |
| `effectiveYearBuilt` | `integer` | Year the building was first assessed with its current components (format: YYYY) |
| `buildingClassificationCode` | `string` | Standard Fire Insurance classification (A = Fireproof Steel, B = Reinforced Concrete, C = Concrete, D = Wood/Steel Frame, S = Incombustible) |
| `buildingCommentText` | `string` | Additional building description information |
| `buildingName` | `string` | County-provided building name (prevalent in commercial or multi-family) |
| `buildingNumber` | `string` | County-provided building number unique within the parcel |
| `buildingSequenceNumber` | `integer` | Sequence number identifying the building within the parcel |
| `fireInsuranceBuildingClassificationCode` | `string` | Fire insurance building classification code |
| `universalBuildingCode` | `string` | Primary building type (e.g. Bowling Alley, Supermarket) |
| `universalConditionCode` | `string` | Physical condition code (e.g. Good, Fair, Under Construction) |
| `universalConditionCodeDescription` | `string` | Description of the condition code |
| `universalGradeCode` | `string` | Overall quality grade (e.g. Fair, Average, Very Good) |
| `universalStyleCode` | `string` | Building style code (e.g. Colonial, Cape Cod, Bungalow) |
| `universalStyleCodeDescription` | `string` | Description of the building style |
### Nested structure objects
Each `Structure` record may contain the following nested objects. All are optional, nullable, and default to `null`.
| Field | Type | Description |
| ---------------------- | ---------------------------------- | --------------------------------------------------------- |
| `attic` | `Attic` | Attic type details |
| `basement` | `Basement` | Basement type, finish, and square footage |
| `bathroom` | `array[Bathroom]` | Bathroom counts and fixture details |
| `ceiling` | `Ceiling` | Ceiling height and type |
| `commercial` | `Commercial` | Commercial building details (units, elevators, vacancies) |
| `dimensions` | `Dimensions` | Square footage breakdowns and building footprint |
| `finishComponents` | `FinishComponents` | Exterior/interior wall, floor, and quality codes |
| `fireplace` | `Fireplace` | Fireplace count and type |
| `functionalComponents` | `StructureFunctionalComponents` | HVAC, plumbing, energy, and elevator details |
| `garageParking` | `GarageParking` | Garage type, capacity, and parking |
| `improvement` | `array[StructureImprovement]` | Building improvements, remodeling, and feature codes |
| `otherImprovements` | `array[OtherStructureImprovement]` | Additional improvement codes |
| `patioPorch` | `PatioPorch` | Patio and porch details |
| `residential` | `StructureResidential` | Residential unit and bedroom counts |
| `rooms` | `array[StructureRooms]` | Additional room type codes |
| `stories` | `StructureStories` | Story count and type |
| `structuralComponents` | `StructuralComponents` | Roof, foundation, and construction type |
***
### Attic
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ------------------------------- | -------- | -------------------------------------- |
| `universalAtticCode` | `string` | CoreLogic standardized attic type code |
| `universalAtticCodeDescription` | `string` | Description of the attic type |
### Basement
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ---------------------------------------- | ------------------ | ------------------------------------------------------------------------------- |
| `basementFinishPercentage` | `number or string` | County percentage of basement finished |
| `basementRooms` | `integer` | Total rooms located in the basement (excluding bathrooms in most jurisdictions) |
| `basementSquareFootage` | `number or string` | Total square footage allocated to all basements on the property |
| `universalBasementCode` | `string` | Standardized basement type code |
| `universalBasementCodeDescription` | `string` | Description of the basement type |
| `universalBasementFinishCode` | `string` | Code identifying the basement's degree of completion |
| `universalBasementFinishCodeDescription` | `string` | Description of the basement finish code |
### Bathroom
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------- |
| `numberOfBathroomFixtures` | `integer` | Total bathroom fixtures (a full bath typically has 4: sink, toilet, bathtub, shower head) |
| `numberOfFullBathrooms` | `integer` | Total full bathrooms (null if source does not break out full vs. partial) |
| `numberOfHalfBathrooms` | `integer` | Total half bathrooms — typically a sink and toilet (null if not broken out) |
| `numberOfOneQuarterBathrooms` | `integer` | Total quarter bathrooms — typically a sink only (null if not broken out) |
| `numberOfThreeQuarterBathrooms` | `integer` | Total three-quarter bathrooms — typically sink, toilet, and shower stall (null if not broken out) |
| `totalNumberOfBathrooms` | `number or string` | Total bathrooms (whole numbers; allows up to 2 decimal places) |
### Ceiling
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ---------------------- | --------- | ------------------------------------------------------------------ |
| `ceilingHeightFootage` | `integer` | Ceiling height in feet |
| `universalCeilingCode` | `string` | CoreLogic standardized ceiling type code (e.g. "BBD" = Bead Board) |
### Commercial
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ---------------------------- | --------- | -------------------------------------------------------- |
| `buildingFloorOrLevelNumber` | `string` | Specific floor or level number (common for condominiums) |
| `buildingSectionNumber` | `string` | Building section indicator (e.g. West Wing, East Wing) |
| `commercialNumberOfUnits` | `integer` | Total separate business units in the building |
| `numberOfVacancies` | `integer` | Number of vacant units in the building |
| `passengerElevatorNumber` | `integer` | Total passenger elevators in the building |
### Dimensions
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ----------------------------------------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `adjustedGrossSquareFootage` | `number or string` | Square footage used by the local taxing authority (typically 100% living + lower % non-living) |
| `grossSquareFootage` | `number or string` | Total square footage for the entire building (all area under the roof) |
| `groundFloorSquareFootage` | `number or string` | Square footage of the ground-level floor |
| `livingSquareFootage` | `number or string` | Heated/air-conditioned living area (excludes garage, porch, unfinished basement) |
| `universalBuildingSquareFootage` | `integer` | Most accurate available square footage for assessments or comparables |
| `universalBuildingSquareFootageIndicator` | `string` | Source of the universal square footage: A = Adjusted, B = Total, D = Ground Floor, G = Gross, L = Living, M = Base/Main |
| `squareFootageDetail` | `array[SquareFootageDetail]` | Itemized square footage breakdowns (see [SquareFootageDetail](#squarefootagedetail)) |
| `footprint` | `Footprint` | Building footprint geometry (see [Footprint](#footprint)) |
#### SquareFootageDetail
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| -------------------------------------------- | ------------------ | ----------------------------------------------- |
| `squareFootageIdentificationCode` | `string` | Square footage type code |
| `squareFootageIdentificationCodeDescription` | `string` | Description of the square footage type |
| `squareFootageNumber` | `number or string` | Square footage above ground level for this type |
#### Footprint
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ------------------- | --------- | ----------------------------------------------------------- |
| `areaSquareFootage` | `integer` | Calculated building size in square feet |
| `imageVintage` | `string` | Date of the source image (format: YYYYMMDD) |
| `imageSource` | `string` | Source of the image used to generate the structure boundary |
| `geometry` | `string` | Building boundary in WKT (Well Known Text) format |
### FinishComponents
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| -------------------------------------- | -------- | ---------------------------------------------------------------- |
| `universalExternalWallCode` | `string` | Exterior wall type/finish code (e.g. Vinyl Siding, Brick Veneer) |
| `universalExternalWallCodeDescription` | `string` | Description of the exterior wall code |
| `universalFloorTypeCode` | `string` | Floor construction type code (e.g. Concrete, Plywood) |
| `universalFloorTypeCodeDescription` | `string` | Description of the floor type code |
| `universalFloorCoverCode` | `string` | Floor covering type code |
| `universalFloorCoverCodeDescription` | `string` | Description of the floor covering code |
| `universalInteriorWallCode` | `string` | Interior wall construction code (e.g. "DRY" = Drywall) |
| `universalInteriorWallCodeDescription` | `string` | Description of the interior wall code |
| `universalQualityCode` | `string` | Construction quality code (e.g. Excellent, Economical) |
| `universalQualityCodeDescription` | `string` | Description of the quality code |
### Fireplace
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ----------------------------------- | --------- | ------------------------------------------------------------------ |
| `fireplaceIndicator` | `string` | "Y" if a fireplace is present in the building |
| `fireplaceNumber` | `integer` | Number of fireplace openings across all buildings on the property |
| `universalFireplaceCode` | `string` | Fireplace type code (reflects the first/main building if multiple) |
| `universalFireplaceCodeDescription` | `string` | Description of the fireplace type |
### StructureFunctionalComponents
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ----------------------------------------- | --------- | --------------------------------------------------------------------- |
| `energyCode` | `string` | County code indicating whether the building has electricity installed |
| `energyCodeDescription` | `string` | Description of the energy code |
| `universalAirConditioningCode` | `string` | Air conditioning type (e.g. Central, Wall Unit, Evaporative) |
| `universalAirConditioningCodeDescription` | `string` | Description of the air conditioning type |
| `universalAirConditioningIndicator` | `string` | Air conditioning indicator |
| `universalEnergyCode` | `string` | Electricity or energy source type |
| `universalEnergyCodeDescription` | `string` | Description of the energy source type |
| `dormerWindowNumber` | `integer` | Number of dormer windows rising above the roof line |
| `elevatorIndicator` | `string` | "Y" if the building has an elevator; null or "N" otherwise |
| `universalFuelCode` | `string` | Fuel type for heating (e.g. Solar, Gas, Oil) |
| `universalFuelCodeDescription` | `string` | Description of the fuel type |
| `universalHeatCode` | `string` | Heating method (e.g. Hot Water, Heat Pump, Baseboard, Radiant) |
| `universalHeatCodeDescription` | `string` | Description of the heating method |
| `universalPlumbingCode` | `string` | Plumbing type code (e.g. "PST" = Standard) |
| `universalSprinklersCode` | `string` | Sprinkler system type (most common in commercial buildings) |
### GarageParking
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ---------------------------------------- | ------------------ | ------------------------------------------------------------------------------- |
| `garageSquareFootage` | `number or string` | Total square footage of the primary garage or parking area |
| `numberOfCarsGarage` | `integer` | Total parking spaces or car capacity for the garage |
| `parkingSpaces` | `integer` | Total parking spaces |
| `universalGarageCapacityCode` | `string` | Garage capacity code |
| `universalGarageCapacityCodeDescription` | `string` | Description of the garage capacity code |
| `universalGarageCode` | `string` | Garage/carport type (e.g. Attached Finished, Enclosed Carport, Basement Garage) |
| `universalParkingTypeCode` | `string` | Parking type — typically commercial or communal (e.g. Condos) |
### StructureImprovement
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ---------------------------------- | --------------------------- | ---------------------------------------------------------------------------- |
| `buildingFeatureNumber` | `integer` | Total number of features or parking capacity associated with the improvement |
| `buildingImprovementValue` | `integer` | Assessed, market, or appraised improvement value |
| `remodeledCode` | `string` | Code describing the nature of remodeling applied to the building |
| `universalBuildingImprovementCode` | `string` | Primary improvement type (e.g. Grain Silo, Hanger, Marina) |
| `improvementFeature` | `array[ImprovementFeature]` | Itemized feature codes (see [ImprovementFeature](#improvementfeature)) |
#### ImprovementFeature
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ---------------------------------------------- | --------- | ------------------------------- |
| `buildingFeatureIdentificationCode` | `string` | Feature identification code |
| `buildingFeatureIdentificationCodeDescription` | `string` | Description of the feature code |
| `buildingFeatureNumber` | `integer` | Count of this feature |
### OtherStructureImprovement
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| --------------------------------- | -------- | ----------------------------------- |
| `otherImprovementCode` | `string` | Additional improvement code |
| `otherImprovementCodeDescription` | `string` | Description of the improvement code |
### PatioPorch
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ------------------------------- | --------- | ------------------------------------------ |
| `patioNumber` | `integer` | Number of patio areas in the building |
| `porchNumber` | `integer` | Number of porches in the building |
| `universalPatioCode` | `string` | Patio type code (e.g. "10B" = Brick Patio) |
| `universalPatioCodeDescription` | `string` | Description of the patio type |
| `universalPorchCode` | `string` | Porch type code (e.g. "B00" = Slab) |
| `universalPorchCodeDescription` | `string` | Description of the porch type |
### StructureResidential
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| -------------------------- | --------- | ------------------------------------------------------------- |
| `numberOfResidentialUnits` | `integer` | Total separate apartments or units in a multi-family building |
| `numberOfBedrooms` | `integer` | Total bedrooms for the building |
### StructureRooms
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| -------------------------- | -------- | ---------------------------- |
| `otherRoomCode` | `string` | Room type code |
| `otherRoomCodeDescription` | `string` | Description of the room type |
### StructureStories
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ---------------------- | ------------------ | ------------------------------------------------- |
| `storiesNumber` | `number or string` | Number of stories in the building |
| `universalStoriesCode` | `string` | Story type (e.g. Split Foyer, Tri Level, 2 Story) |
### StructuralComponents
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ------------------------------------------ | -------- | ------------------------------------------------------------------------ |
| `universalRoofFrameCode` | `string` | Wall framing type (e.g. Bar Joist, Reinforced Concrete, Flexicore) |
| `universalConstructionTypeCode` | `string` | Primary construction method code (e.g. Steel/Glass, Concrete Block, Log) |
| `universalConstructionTypeCodeDescription` | `string` | Description of the construction method |
| `universalFoundationCode` | `string` | Foundation type (e.g. Continuous Footing, Pier, Mud Sill) |
| `universalFoundationCodeDescription` | `string` | Description of the foundation type |
| `universalRoofCode` | `string` | Roof type (e.g. Gambrel, Gable, Flat, Mansard) |
| `universalRoofCodeDescription` | `string` | Description of the roof type |
| `universalRoofCoverCode` | `string` | Roof covering type (e.g. Clay Tile, Aluminum, Shake) |
| `universalRoofCoverCodeDescription` | `string` | Description of the roof covering type |
***
## Property attributes fields
The `propertyAttributes` object contains ownership, location, utilities, and feature data. All fields are optional, nullable, and default to `null`.
### Top-level property attributes
| Field | Type | Description |
| ------------------------------ | -------- | -------------------------------------------------------------------------------------------- |
| `absenteeOwnerCode` | `string` | Indicates whether the owner resides at the property (M/O/S = owner occupied; A/T = absentee) |
| `absenteeOwnerCodeDescription` | `string` | Description of the absentee owner code |
| `absenteeOwnerIndicator` | `string` | Absentee owner indicator |
| `ownerOccupiedIndicator` | `string` | Owner-occupied indicator |
| `mobileHomeCode` | `string` | "Y" if a manufactured home is present on the property |
| `mobileHomeCodeDescription` | `string` | Description of the mobile home code |
| `parcelCommentText` | `string` | Additional parcel description information |
| `jurisdictionCountyCode` | `string` | County jurisdiction code |
| `legalPropertyDescription` | `string` | Legal description delineating exact property boundaries |
### Nested property attributes objects
| Field | Type | Description |
| ---------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------- |
| `summaryData` | `SummaryData` | Aggregate counts and square footages across all buildings (see [SummaryData](#summarydata)) |
| `owner` | `array[Owner]` | Owner records (see [Owner](#owner)) |
| `propertyRights` | `PropertyRights` | Zoning codes (see [PropertyRights](#propertyrights)) |
| `exteriorFixtures` | `ExteriorFixtures` | Pool, easement, and exterior fixture codes (see [ExteriorFixtures](#exteriorfixtures)) |
| `map` | `PropertyAttributesMap` | Survey coordinates and plat map references (see [Map](#map)) |
| `location` | `PropertyAttributesLocation` | Census, CBSA, municipality, and township data (see [Location](#location)) |
| `functionalComponents` | `PropertyAttributesFunctionalComponents` | Parcel-level utility codes (see [FunctionalComponents](#functionalcomponents)) |
| `features` | `PropertyAttributesFeatures` | View and location influence codes (see [Features](#features)) |
***
### SummaryData
Aggregate statistics calculated across all buildings on the parcel. All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ----------------------------------- | ------------------ | ------------------------------------------------------------------------------------ |
| `summaryNumberOfBuildings` | `integer` | Total buildings on the parcel |
| `totalNumberOfBuildings` | `integer` | Total buildings on the parcel |
| `summaryOfLivingSpace` | `number or string` | Total living area across all buildings (excludes garage, porch, unfinished basement) |
| `summaryTotalBuildingSquareFootage` | `number or string` | Total square footage for all buildings on the property |
| `summaryAboveAreaSquareFootage` | `number or string` | Total above-ground square footage for all buildings |
| `summaryAdjustedAreaSquareFootage` | `number or string` | Total open-area square footage for the property |
| `summaryBasementSquareFootage` | `number or string` | Total basement square footage for the property |
| `summaryNumberOfBedrooms` | `integer` | Total bedrooms across all buildings |
| `numberOfRooms` | `integer` | Total rooms as supplied by the source |
| `summaryNumberOfRooms` | `integer` | Total rooms across all buildings |
| `summaryNumberOfBathrooms` | `integer` | Total bathroom rooms across all buildings |
| `summaryNumberOfFullBathrooms` | `integer` | Total full bathrooms (null if source does not distinguish) |
| `summaryNumberOfHalfBathrooms` | `integer` | Total half bathrooms (null if source does not distinguish) |
| `summaryNumberOf1QuarterBathrooms` | `integer` | Total quarter bathrooms (null if source does not distinguish) |
| `summaryNumberOf3QuarterBathrooms` | `integer` | Total three-quarter bathrooms (null if source does not distinguish) |
| `summaryNumberOfBathroomsFixtures` | `integer` | Total bathroom fixtures across all buildings |
| `summaryNumberOfFireplaces` | `integer` | Total fireplace openings across all buildings |
| `summaryNumberOfElevators` | `integer` | Total elevators |
| `summaryNumberOfBusinessUnits` | `integer` | Total residential, apartment, or business units |
| `summaryOfRentalSpace` | `number or string` | Total rental square footage across all buildings |
| `summaryOfOfficeSpace` | `number or string` | Total office spaces on the property |
| `summaryNumberOfLoadingDocks` | `integer` | Total loading docks |
| `summaryNumberOfRailSpurs` | `integer` | Total rail spurs on the property |
| `summaryNumberOfTruckDoors` | `integer` | Total truck doors on the property |
### Owner
Each entry in the `owner` array contains two nested objects. Both fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| -------------- | -------------- | --------------------------- |
| `ownerDetails` | `OwnerDetails` | Name and ownership metadata |
| `ownerAddress` | `OwnerAddress` | Mailing address details |
#### OwnerDetails
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ------------------------- | --------- | ----------------------------------------------------------------------------------------- |
| `fullName` | `string` | Full name of the property owner |
| `firstName` | `string` | First name of the property owner |
| `middleInitial` | `string` | Middle initial |
| `lastName` | `string` | Last name or additional owner name |
| `corporateIndicator` | `string` | Indicates the owner is a corporation or business |
| `nameSequenceNumber` | `integer` | Owner sequence number |
| `relationshipTypeCode` | `string` | Relationship between multiple owners or marital status (e.g. Husband/Wife, Unmarried Man) |
| `ownerBuyerEtAlIndicator` | `string` | Indicates additional unnamed owners: A = ET AL, C = ET CON, U = ET UX, V = ET VIR |
| `ownershipRightsCode` | `string` | Form of property ownership (e.g. Joint Tenants, Living Trust) |
#### OwnerAddress
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ------------------- | ---------------- | --------------------------------------------------------------- |
| `address1` | `string` | Full mailing address line (e.g. "123 N Main St") |
| `city` | `string` | Mailing address city |
| `state` | `string` | Two-letter USPS state abbreviation |
| `zipCode` | `string` | 5-digit or 9-digit ZIP code |
| `zipPlus4Code` | `string` | Last 4 digits of the 9-digit ZIP code |
| `carrierRoute` | `string` | Four-digit USPS carrier route code |
| `house1Number` | `string` | House number (digits left of the street name) |
| `suffixCode` | `string` | House number suffix (e.g. "B" in "202B Jones Rd") |
| `house2Number` | `string` | Second number in an address range |
| `predirectionCode` | `string` | Street directional prefix (e.g. "N" in "9340 N Dunhill Dr") |
| `streetName` | `string` | Street name or number |
| `modeCode` | `string` | Street type suffix (e.g. "Dr" in "9340 N Dunhill Dr") |
| `postdirectionCode` | `string` | Street directional suffix (e.g. "SW" in "2040 NW 100 ST SW") |
| `unitNumber` | `string` | Unit or suite number |
| `originalCountry` | `string` | Country name for foreign mailing addresses |
| `careOfName` | `string` | Name of the person receiving mail on behalf of the owner |
| `foreignAddress` | `ForeignAddress` | Foreign address object containing `foreignAddressFull` (string) |
### PropertyRights
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ---------------------------- | -------- | -------------------------------------------------------- |
| `primaryZoneCode` | `string` | County/local zoning code (not standardized by CoreLogic) |
| `primaryZoneCodeDescription` | `string` | Zoning code description |
### ExteriorFixtures
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ------------------------------ | -------- | ----------------------------------------------------------------------------- |
| `easementTypeCode` | `string` | Easement type code (e.g. "2" = Flood Control Easement) |
| `easementTypeCodeDescription` | `string` | Description of the easement type |
| `universalPoolCode` | `string` | Pool type, construction, or amenity code (e.g. Kidney, Gunite, Vinyl, Heated) |
| `universalPoolCodeDescription` | `string` | Description of the pool code |
| `universalPoolIndicator` | `string` | Pool indicator |
### Map
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ---------------- | -------- | ------------------------------------------------------------------------------- |
| `rangeCode` | `string` | Geographic range from local surveys (east/west of meridian, 6-mile intervals) |
| `sectionCode` | `string` | Geographic section (1 square mile; 36 sections per Range/Township intersection) |
| `quarterSection` | `string` | Quarter section (NE, NW, SE, SW) |
| `platmapBook` | `string` | Reference to the recorded subdivision map book in county records |
| `platmapPage` | `string` | Reference to the recorded subdivision map page in county records |
### Location
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ---------------------------------------- | -------- | -------------------------------------------------------------------------------------- |
| `townCode` | `string` | Town code (some counties use this instead of municipality codes) |
| `townCodeDescription` | `string` | Description of the town code |
| `cbsaCode` | `string` | Core Based Statistical Area code (U.S. Office of Management and Budget) |
| `cbsaName` | `string` | CBSA name |
| `cbsaType` | `string` | CBSA type (Metropolitan or Micropolitan) |
| `metropolitanDivisionCode` | `string` | CBSA division number |
| `metropolitanDivisionName` | `string` | CBSA division name |
| `censusIdentification` | `string` | Census Tract + Block Group + Block identifier |
| `townshipRangeSectionConfigurationValue` | `string` | Standardized value combining first two characters from Township, Range, and Section |
| `mlsMarketArea` | `string` | Geographic area defined by the local Multiple Listing Service board |
| `municipalityCode` | `string` | Municipality code |
| `municipalityCodeDescription` | `string` | Municipality name |
| `townshipCode` | `string` | Township portion of geographic coordinates (north/south of meridian, 6-mile intervals) |
| `townshipCodeDescription` | `string` | Description of the township code |
| `situsCensusTract` | `string` | Census Tract, Block Group, Block, and Block Suffix (U.S. Bureau of the Census) |
### FunctionalComponents
Parcel-level utility and service codes. All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| ------------------------------------- | -------- | ---------------------------------------------------------------- |
| `universalFuelCode` | `string` | Fuel type for heating (e.g. Solar, Gas, Oil) |
| `universalFuelCodeDescription` | `string` | Description of the fuel type |
| `universalElectricityCode` | `string` | Electricity/wiring type (e.g. Average Wiring, Underground Wired) |
| `universalElectricityCodeDescription` | `string` | Description of the electricity type |
| `universalSewerCode` | `string` | Sewer system type (e.g. Public, Septic, Commercial) |
| `universalSewerCodeDescription` | `string` | Description of the sewer type |
| `universalUtilitiesCode` | `string` | General utility type (e.g. Electric, Oil, Private) |
| `universalUtilitiesCodeDescription` | `string` | Description of the utility type |
| `universalWaterCode` | `string` | Water service type (e.g. Public, Well, Cistern) |
| `universalWaterCodeDescription` | `string` | Description of the water type |
### Features
All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| --------------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `viewCode` | `string` | View from building (e.g. Gulf, Mountains, Pool) |
| `viewCodeDescription` | `string` | Description of the view code |
| `locationInfluence` | `LocationInfluence` | Nested object with `universalLocationInfluenceCode` and `universalLocationInfluenceCodeDescription` — positive or negative location aspects (e.g. Waterfront, Flood Plain, Airport) |
***
## Sample response
```json theme={null}
{
"success": true,
"count": 1,
"data": [
{
"clip": "123456789",
"propertyCharacteristics": {
"land": {
"landDimensionAcresTotal": 0.15,
"landDimensionSquareFeetTotal": 6534,
"landUseCode": "163",
"landUseCodeDescription": "SFR",
"propertyIndicatorCode": "10",
"propertyIndicatorCodeDescription": "Single Family Residence",
"landUseCountyCode": "0100",
"landUseCountyCodeDescription": "SINGLE FAMILY RESIDENTIAL",
"legalBlockIdentification": "12",
"standardSubdivisionCode": "HIGHLAND MILLS ESTATES",
"subdivisionTractNumber": "7432",
"universalTotalValue": 485000,
"universalTotalValueSourceIndicator": "A",
"lot": [{ "legalLotIdentification": "34", "lotSequenceNumber": 1 }],
"landDimension": [
{
"landDimensionSquareFeet": 6534,
"landDimensionDepth": 110,
"landDimensionFront": 60,
"landDimensionSequence": 1,
"landDimensionTypeCode": "RCT",
"landDimensionTypeCodeDescription": "Rectangular"
}
],
"topography": [{ "universalTopographyCode": "FLT", "universalTopographyCodeDescription": "Flat/Level" }]
},
"structure": [
{
"structureId": "1",
"actualYearBuilt": 1962,
"effectiveYearBuilt": 1998,
"universalConditionCode": "AV",
"universalConditionCodeDescription": "AVERAGE",
"universalStyleCode": "109",
"universalStyleCodeDescription": "RANCH",
"bathroom": [{ "numberOfFullBathrooms": 2, "totalNumberOfBathrooms": 2 }],
"dimensions": {
"grossSquareFootage": 1700,
"livingSquareFootage": 1450,
"universalBuildingSquareFootage": 1450,
"universalBuildingSquareFootageIndicator": "L"
},
"finishComponents": { "universalExternalWallCode": "FR", "universalExternalWallCodeDescription": "WOOD FRAME" },
"fireplace": { "fireplaceIndicator": "Y", "fireplaceNumber": 1 },
"functionalComponents": {
"universalAirConditioningCode": "CNT",
"universalAirConditioningCodeDescription": "CENTRAL",
"universalFuelCode": "GS",
"universalHeatCode": "FA",
"universalHeatCodeDescription": "FORCED AIR"
},
"garageParking": { "garageSquareFootage": 440, "numberOfCarsGarage": 2, "universalGarageCode": "ATF" },
"residential": { "numberOfResidentialUnits": 1, "numberOfBedrooms": 3 },
"stories": { "storiesNumber": 1, "universalStoriesCode": "1" },
"structuralComponents": {
"universalConstructionTypeCode": "FR",
"universalConstructionTypeCodeDescription": "WOOD FRAME",
"universalFoundationCode": "SLB",
"universalFoundationCodeDescription": "SLAB",
"universalRoofCoverCode": "CMP",
"universalRoofCoverCodeDescription": "COMPOSITION SHINGLE"
}
}
],
"propertyAttributes": {
"absenteeOwnerCode": "O",
"absenteeOwnerCodeDescription": "OWNER OCCUPIED",
"ownerOccupiedIndicator": "Y",
"jurisdictionCountyCode": "06037",
"legalPropertyDescription": "LOT 34 BLK 12 HIGHLAND MILLS ESTATES TR 7432",
"owner": [
{
"ownerDetails": { "fullName": "SAMPLE OWNER", "firstName": "SAMPLE", "lastName": "OWNER" },
"ownerAddress": { "address1": "123 MAIN ST", "city": "LOS ANGELES", "state": "CA", "zipCode": "90001" }
}
],
"propertyRights": { "primaryZoneCode": "R1", "primaryZoneCodeDescription": "SINGLE FAMILY RESIDENTIAL" },
"location": {
"cbsaCode": "31080",
"cbsaName": "Los Angeles-Long Beach-Anaheim, CA",
"cbsaType": "Metropolitan"
},
"functionalComponents": {
"universalSewerCode": "PUB",
"universalSewerCodeDescription": "PUBLIC",
"universalWaterCode": "PUB",
"universalWaterCodeDescription": "PUBLIC"
}
}
}
}
],
"messages": []
}
```