CLIP tools - Cotality developer portal

What CLIP is: A unique, persistent numeric identifier assigned by Cotality to every US property parcel — residential and commercial. CLIP is the required input for Property characteristics, Climate risk analytics, and Analytics. Always call a CLIP tool first when starting from an address. Data capabilities:

Tool	Input	Returns	Use cases
`clip-find_property_by_clip`	CLIP identifier	Address, APN, owner name, geocode, parcel details	Cross-reference by CLIP, ownership lookup, coordinate resolution
`clip-find_property_by_full_address`	Full street address	CLIP + address, APN, owner name, geocode, parcel details	Address-to-CLIP resolution, address validation, mortgage and appraisal workflows

Data scope:

Attribute	Value
Coverage	All US property parcels — residential and commercial
Output	Response envelope — `success`, `data` (array of `PropertyData`), `count`, `messages`
Note	A CLIP query may return multiple records when one parcel maps to more than one property record

`clip-find_property_by_clip`

Retrieve comprehensive property data using a CLIP identifier. CLIP is a unique, persistent identifier assigned by Cotality to each property in the United States. When to use:

You have a CLIP identifier and need detailed property information
Looking up property ownership, address, parcel numbers (APN), or geographic coordinates
Cross-referencing properties across different systems using CLIP as the key

Examples:

“Get property details for CLIP 123456789”
“Find owner information for CLIP 456789123”

Input schema

Parameter	Type	Required	Description
`clip`	`string`	Yes	A numeric CLIP identifier (e.g. `"123456789"`)

The provided CLIP must be a non-empty string consisting only of numeric characters.

Example request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "clip-find_property_by_clip",
    "arguments": {
      "clip": "123456789"
    }
  }
}

Output schema

The response envelope is shared by both CLIP tools. See Response envelope and PropertyData fields below.

The response includes an array of property records, because multiple properties may share the same CLIP in certain scenarios.

`clip-find_property_by_full_address`

Retrieve comprehensive property data using a complete street address. This tool performs address-based property lookup when you have a full address but not the CLIP identifier. When to use:

You have a street address and need property details
Converting addresses to CLIP identifiers for further processing
Looking up property ownership by address

Examples:

“Find property data for 123 Main Street, Los Angeles, CA 90001”
“Get CLIP and owner info for 456 Oak Avenue, Apt 2B, Chicago, IL 60601”

Input schema

Parameter	Type	Required	Description
`full_address`	`string`	Yes	Full street address — ideally including street number and name, unit/apartment (if applicable), city, state, and ZIP code

Full address must be a valid, non-empty string. The more complete and accurate the address, the better the match. Returns an array of property records as fuzzy matching may return multiple candidates.

Example request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "clip-find_property_by_full_address",
    "arguments": {
      "full_address": "123 Main Street, Los Angeles, CA 90001"
    }
  }
}

Output schema

The response envelope is shared by both CLIP tools. See Response envelope and PropertyData fields below.

Response envelope

Both tools return an identical envelope:

Field	Type	Description
`success`	`boolean`	Whether the request completed successfully
`data`	`array[PropertyData]`	Array of matching 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.

PropertyData fields

Each object in the data array is a PropertyData record. All fields are optional, nullable, and default to null.

Field	Type	Description
`clip`	`string`	CoreLogic Integrated Property identifier
`clipStatus`	`string`	Status of the CLIP record
`countyCode`	`string`	FIPS county code
`county`	`string`	County name
`apnUnformatted`	`string`	Assessor Parcel Number — raw, unformatted
`apnFormatted`	`string`	Assessor Parcel Number — formatted
`previousApnUnformatted`	`string`	Previous APN (before parcel replatting)
`alternateApn`	`string`	Alternate APN on file
`universalParcelId`	`string`	Universal Parcel ID
`apnSequenceNumber`	`integer`	APN sequence number
`addressId`	`integer`	Internal address identifier
`addressStatus`	`string`	Status of the address record
`fullAddress`	`string`	Full assembled address string
`addressLine`	`string`	Street address line
`cityLine`	`string`	City/state/zip line
`houseNumber`	`string`	House / street number
`streetNamePrefixDirection`	`string`	Street directional prefix (e.g. “N”, “SW”)
`streetNamePrefix`	`string`	Street name prefix
`streetNameBase`	`string`	Base street name
`streetName`	`string`	Street name
`streetNameSuffix`	`string`	Street suffix (e.g. “St”, “Ave”)
`streetNameSuffixDirection`	`string`	Street directional suffix
`streetNameFull`	`string`	Fully assembled street name
`unitType`	`string`	Unit type (e.g. “APT”, “STE”)
`unitNumber`	`string`	Unit / apartment number
`city`	`string`	City name
`uspsRecommendedCity`	`string`	USPS-recommended city name
`state`	`string`	State abbreviation
`zipCode`	`string`	5-digit ZIP code
`zipPlus4`	`string`	ZIP+4 code
`countryCode`	`string`	Country code
`streetSide`	`string`	Side of street (e.g. “L”, “R”)
`unitRangeHigh`	`string`	High end of unit range
`unitRangeLow`	`string`	Low end of unit range
`latitude`	`number`	Latitude coordinate
`longitude`	`number`	Longitude coordinate
`owner1Name`	`string`	Primary owner name
`owner2Name`	`string`	Secondary owner name
`matchCode`	`string`	Match code indicating address match quality
`propertyMatchScore`	`integer`	Numeric match score
`addressAttributes`	`AddressAttributes`	Nested address-level detail (see below)

AddressAttributes

The optional addressAttributes nested object contains additional address-level and geocoding detail. All fields are optional, nullable, and default to null.

Field	Type	Description
`addressId`	integer	Internal address identifier
`addressStatus`	string	Status of the address record
`addressType`	string	Address type classification
`fullAddress`	string	Full assembled address
`addressLine`	string	Street address line
`cityLine`	string	City/state/zip line
`houseNumber`	string	House / street number
`streetNamePrefixDirection`	string	Street directional prefix
`streetNamePrefix`	string	Street name prefix
`streetNameBase`	string	Base street name
`streetName`	string	Street name
`streetNameSuffix`	string	Street suffix
`streetNameSuffixDirection`	string	Street directional suffix
`streetNameFull`	string	Fully assembled street name
`unitNumber`	string	Unit / apartment number
`unitType`	string	Unit type
`city`	string	City name
`uspsRecommendedCity`	string	USPS-recommended city name
`state`	string	State abbreviation
`zipCode`	string	5-digit ZIP code
`zipPlus4`	string	ZIP+4 code
`countryCode`	string	Country code
`streetSide`	string	Side of street
`unitRangeHigh`	string	High end of unit range
`unitRangeLow`	string	Low end of unit range
`addressMatchDescription`	string	Human-readable match description
`addressMatchRecord`	string	Matched record identifier
`addressMatchCode`	string	Address match code
`matchCode`	string	Overall match code
`latitude`	number	Latitude coordinate
`longitude`	number	Longitude coordinate
`geocodeDataSet`	string	Geocoding dataset used
`geocodeVendor`	string	Geocoding vendor name
`admin1`	string	Administrative division level 1
`admin2`	string	Administrative division level 2
`admin3`	string	Administrative division level 3
`admin4`	string	Administrative division level 4
`admin5`	string	Administrative division level 5
`admin6`	string	Administrative division level 6
`admin7`	string	Administrative division level 7

Sample response

{
  "success": true,
  "count": 1,
  "data": [
    {
      "clip": "123456789",
      "clipStatus": "A",
      "countyCode": "06037",
      "county": "Los Angeles",
      "apnUnformatted": "4321012034",
      "apnFormatted": "4321-012-034",
      "previousApnUnformatted": null,
      "alternateApn": null,
      "universalParcelId": "06037-4321-012-034",
      "apnSequenceNumber": 1,
      "addressId": 100200300,
      "addressStatus": "A",
      "fullAddress": "123 MAIN ST, LOS ANGELES, CA 90001",
      "addressLine": "123 MAIN ST",
      "cityLine": "LOS ANGELES, CA 90001",
      "houseNumber": "123",
      "streetNamePrefixDirection": null,
      "streetNamePrefix": null,
      "streetNameBase": "MAIN",
      "streetName": "MAIN",
      "streetNameSuffix": "ST",
      "streetNameSuffixDirection": null,
      "streetNameFull": "MAIN ST",
      "unitType": null,
      "unitNumber": null,
      "city": "LOS ANGELES",
      "uspsRecommendedCity": "LOS ANGELES",
      "state": "CA",
      "zipCode": "90001",
      "zipPlus4": "1234",
      "countryCode": "US",
      "streetSide": null,
      "unitRangeHigh": null,
      "unitRangeLow": null,
      "latitude": 34.0522,
      "longitude": -118.2437,
      "owner1Name": "SAMPLE OWNER",
      "owner2Name": null,
      "matchCode": "E01",
      "propertyMatchScore": 100,
      "addressAttributes": {
        "addressId": 100200300,
        "addressStatus": "A",
        "addressType": "PRIMARY",
        "fullAddress": "123 MAIN ST, LOS ANGELES, CA 90001",
        "addressLine": "123 MAIN ST",
        "cityLine": "LOS ANGELES, CA 90001",
        "houseNumber": "123",
        "streetNamePrefixDirection": null,
        "streetNamePrefix": null,
        "streetNameBase": "MAIN",
        "streetName": "MAIN",
        "streetNameSuffix": "ST",
        "streetNameSuffixDirection": null,
        "streetNameFull": "MAIN ST",
        "unitNumber": null,
        "unitType": null,
        "city": "LOS ANGELES",
        "uspsRecommendedCity": "LOS ANGELES",
        "state": "CA",
        "zipCode": "90001",
        "zipPlus4": "1234",
        "countryCode": "US",
        "streetSide": null,
        "unitRangeHigh": null,
        "unitRangeLow": null,
        "addressMatchDescription": "Exact match",
        "addressMatchRecord": null,
        "addressMatchCode": "E01",
        "matchCode": "E01",
        "latitude": 34.0522,
        "longitude": -118.2437,
        "geocodeDataSet": "PARCEL",
        "geocodeVendor": "COTALITY",
        "admin1": "CA",
        "admin2": "Los Angeles",
        "admin3": null,
        "admin4": null,
        "admin5": null,
        "admin6": null,
        "admin7": null
      }
    }
  ],
  "messages": []
}

​clip-find_property_by_clip

​Input schema

​Example request

​Output schema

​clip-find_property_by_full_address

​Input schema

​Example request

​Output schema

​Response envelope

​PropertyData fields

​AddressAttributes

​Sample response

`clip-find_property_by_clip`

Input schema

Example request

Output schema

`clip-find_property_by_full_address`

Input schema

Example request

Output schema

Response envelope

PropertyData fields

AddressAttributes

Sample response