Bridge API Documentation

The Bridge API Platform

Formerly known as Retsly, The Bridge API platform is middleware that helps you access multiple MLS listing datasets and real estate public records. The data is all delivered in a normalized way through an elegant and familiar RESTful API. The Bridge API also facilitates managing the necessary data licenses for you and data providers with a standardized approval process.

By enabling simple access to an array of datasets in a consistent format, you are ready to scale. Integrate with API once, and as soon as data licenses are approved, they are instantly available. To help take your product further, we provide a variety of integrated services, including a Push API, secure OAuth user authentication and usage analytics.

Signing up with Bridge API

The Bridge API is currently live, but accessible by invite only. To request an invite contact us through our support channel.

Support

If you have any questions, feel free to contact us:

The Bridge API Dashboard

We've endeavored to make the process of applying for and managing data licenses as straightforward as possible, for both developers and data providers. To this end, we've designed a simple workflow made up of three steps:

  • Register your application to get API access tokens.
  • Complete your application's profile and submit it to us for a quick review.
  • Apply for access to datasets.

Registering an application

Immediately after creating your account and registering an application, you will receive your Client ID, Client Secret, Browser and Server tokens. These will all be used in integrating your application with the API. Additionally:

  • You can start integrating with the Bridge API test datasets.
  • You can begin using Bridge API dashboard to track API usage and data analytics.
  • You can integrate user authentication on multiple platforms, using the Bridge API Secure Sign-in OAuth flow.
  • You can set up webhooks to test push functionality using our dynamic test datasets.

IP and Domains whitelisting

Authorization tokens will only work on the HTTP referrer domains and IP addresses you have specified for your application. You may specify multiple domains, but no wildcards. If no domains or IPs have been set, this validation is skipped.

Authorization Tokens

Your Client ID is your application's unique identifier. Your Client Secret is an additional token used for authenticating your application and should only be used in server to server exchanges. Browser and Server tokens are used to identify and authorize your application to get data using the Bridge API. Generally you would use the Server token for most exchanges.

Testing if your application works

The easiest way to check if you application has been correctly registered is to use our API Explorer. Simply copy your Server token, open the API Explorer for any MLS listing data resource, and paste the token into the access_token parameter. As long as the dataset parameter is one of the Test datasets, you should receive a Successful (200) response.

Alternatively, use this simple cURL request, using your application's Server token:

curl https://rets.io/api/v2/test/listings?access_token={your_server_token}

Configuring OAuth

If you intend on using our authentication flow, you will need to specify the callback URI. The callback URI should match the HTTP referrer domain. Read more about integrating oAuth below.

Regenerating your Client Secret

You're able to regenerate your Client Secret at any time. It's important to note that the Client Secret is used in the generation of both Server and Browser tokens, and when regenerating you are effectively expiring all tokens that were generated off that Client Secret. It may be useful to regenerate your Client Secret if your Client Secret or any of the subsequent tokens have been compromised.

Data Licenses

The datasets are accessed with the datasets resource on the API, each corresponding to a data provider (such as an MLS).

Pre-approved Test datasets

As soon as your application has been registered, you are able to access our Test datasets. Sample data has no correlation to real MLS data. The machine-generated test data represents available datasets to allow you to develop a proof of concept that shows how your application will integrate with real data providers. It is recommended that you integrate your application using these datasets before applying for data licenses.

  • Static MLS test dataset: This simulates the listing data you would receive from an MLS. This simple dataset will not update. The dataset ID is test. This is the default on the API Explorer.
  • Dynamic test datasets: There are two dynamic test datasets available. These also simulate MLS listing data, but the data is updated every 15 minutes to mimic the regular data updates you'd commonly see on an actual MLS dataset (e.g. listing status, price updates, photo updates, etc). The dataset IDs are test_sf and test_sd.

Licensed datasets

All other datasets besides Test datasets require approval from their respective providers. Access to the data remains at the discretion of the data provider. The time it takes each data provider to review and approve your application for a data license will vary, as will the specific usage requirements. The data provider has the right to flag your application for compliance review, and revoke your license if there is a breach of usage regulations. The available data providers are updated as they come onto the Bridge API platform.

Completing your application's profile

Your application's profile is used by the MLSs and other data providers to approve you for data access. Is is extremely important that the profile is fleshed out as much as possible to facilitate a positive outcome. Previously, a developer would have needed to go through many different application procedures to get access to various datasets. On the Bridge API platform, you're able to apply for multiple data providers with the same one. You are able to update the profile at any time.

The information required includes information such as a complete application description, website URL, support information, and screenshots. The icon is used only within the Bridge API platform. Adding a link to a working demo would be beneficial.

The license questionnaire is important as it will be used by the data providers to decide if your application will make suitable use of their data. Fill out these answers with as much detail as possible.

Bridge API application review

Prior to applying for datasets, we request that you first get it quickly reviewed by us. This only needs to be done once. This quick once-over by our team helps both parties: it ensures that the data providers are not getting spammed with unsuitable applications, and that developers don't waste valuable time sending license requests that are doomed to fail because of recognizable errors or ommissions.

Managing data licenses

Once your application has been successfully reviewed, you can begin applying for data access. Simply go into your application's settings, choose the dataset you'd like access to, and click apply. Your application profile will then be sent to the relevant data provider for approval. If you want to withdraw your application, you can recall it at any time.

Should you choose to remove an application's data license once it's been approved, please note you will need to begin the application process again.

The following statuses are applied to your data license:

  • Pending: Your application has been submitted to the data provider, and is pending approval.
  • Approved: Your application has been approved by the data provider, and the data is available through the Bridge API.
  • Denied: Your application has been denied for a data license. A reason will be supplied when you are notified of this status change. You may apply again if desired.
  • Under compliance review: Your application has been flagged for compliance review. The data feed is still active.
  • Revoked: Your compliance review and resolution was not successful, and the data provider has revoked your access to their data. The data feed for this resource is no longer available. You will need to reapply to regain access.

Data provider feedback

During and after the license approval process, communication between yourself, Bridge API and the data providers can be managed using the integrated feedback widget.

Compliance review

An application's access to a dataset may be flagged for compliance review by either the Bridge API or the data provider. This will likely be the result of a breach in usage regulations. While under compliance review you will still have access to the data feed. An engineer from the Bridge API will attempt to contact you to resolve the issue.

Analytics

One of the strengths of the Bridge API platform is our analytics. You can view aggregate data from all your applications, as well as data analytics for individual applications.

Any time an application makes a request to the Bridge API through an application token or a user token, Bridge API tracks the requested data and stores the information.

During application development, you can view the data analytics for your application using the sample Test data we have provided. Once you have received approval for your application to access and interact with data providers, and your application begins to receive traffic from users, you can view analytics for live data.

The Bridge API

Formerly known as the Retsly API, the Bridge API is the portal through which you access normalized data. You can integrate your application with our RESTful API using HTTPS requests or with the help of the opensource SDKs (although in most cases you shouldn't need the). HTTPS is required; Bridge only responds to encrypted traffic so that the data remains safe.

Exploring the API

API status

Our system status is available here.

API Explorer

Our API Explorer is the simplest way to query the API. Using your application's token, you can get a response from any of the Test datasets, as well as any datasets that have been approved for that application. Paste in your token, enter the desired dataset ID as the datasetID and build your query.

By default, the static Test dataset is used in the API Explorer (and in the examples in this documentation).

Querying the API

For a complete list of available resources and parameters, please see the Bridge API Reference. Results are limited to 10 by default.

Authentication

Every request to the Bridge API must supply a valid API token. You can get an API token through the OAuth flow, or in the Bridge API Dashboard.

Your application should send an Authorization header with every HTTP request to the API:

Authorization: Bearer {token}

If you can't set headers (such as in an XHR request from a browser), or at your option, you can send the token in the access_token parameter in the query string of your request:

GET https://rets.io/api/v2/test/listings?access_token={your_server_token}

Operators

You can constrain the result set of a resource by passing additional operators with your request. The format is as follows:

{parameter}[{operator}] = {value}

Alternatively, dot notation is also available if preferred:

{parameter}.{operator} = {value}

Valid operators include:

OperatorDescription
eq equal
ne not equal
gt greater than
lt less than
gte greater than or equal
lte less than or equal
in comma-separated list, equal only

If the operator is omitted, the eq operator is assumed.

Parameters

The following query parameters may be passed to narrow down your results. Over time, more fields and aggregation options will be added and more resources will be supported. Depending on the resource, some parameters may be required or unavailable.

Note that geographic coordinates should be ordered {Lng},{Lat} and contain a decimal.

Path Parameters
NameTypeDescription
access_token stringToken to identify the application. This is always required.Example request: return all datasets approved for an applicationhttps://rets.io/api/v2/datasets?access_token=access_token
datasetID stringSpecifies the dataset to get the data from.Example: return all listings from the Test datasethttps://rets.io/api/v2/dataset_id/listings?access_token=access_token
listingId stringThe listing ID, available on the /listings resource.Example: return data relating to a specific listinghttps://rets.io/api/v2/dataset_id/listings/e98b11e1c2d285e4e72d90715cce4eda?access_token=access_token
agentId stringThe Agent ID, available on the /agents resource.Example: Return data relating to a specific agenthttps://rets.io/api/v2/dataset_id/agents/12cb9f9379896c2a2c24ba3c0fb22a67?access_token=access_token
officeId stringThe office ID, available on the /offices resource.Example: Return data relating to a specific officehttps://rets.io/api/v2/dataset_id/offices/e15b3d8c09e583a04d123872318096c8?access_token=access_token
openhouseId stringThe openhouse ID, available on the /openhouses resource.Example: Return data relating to a specific openhousehttps://rets.io/api/v2/dataset_id/openhouses/92b4e7e697e0fb0e2e3732aa701ffa13?access_token=access_token
summary stringSummary endpoint, currently only available for MLS listings data.Example: Return summary data for the Test datasethttps://rets.io/api/v2/dataset_id/listings/summary?access_token=access_token
Query parameters
NameTypeDescription
offset numberSkips this number of results.Example: Skip the first 10 listings of the Test datasethttps://rets.io/api/v2/dataset_id/listings?access_token=access_token&offset=10
limit numberLimits the size of the result set. Default is 10.Example: Limit results from the Test dataset to only 2https://rets.io/api/v2/dataset_id/listings?access_token=access_token&limit=2
sortBy stringResponse field to sort query by.Example: Sort order by pricehttps://rets.io/api/v2/dataset_id/listings?access_token=access_token&sortBy=price
order stringOrder of responses: "asc/desc".Example: Sort order by descending pricehttps://rets.io/api/v2/dataset_id/listings?access_token=access_token&sortBy=price&order=asc
near stringCoord or location e.g. near={Lng},{Lat} or near=San DiegoExample: Return listings that are near specific co-ordinateshttps://rets.io/api/v2/dataset_id/listings?access_token=access_token&limit=2&near=-122.395743,37.793662
radius stringRadius to search within. Can be suffixed with units mi(miles) or km(kilometer). Miles are default.Example: Return listings that near to specific co-ordinants, constrained 5 mileshttps://rets.io/api/v2/dataset_id/listings?access_token=access_token&limit=2&near=-122.395743,37.793662&radius=5mi
box stringIf you know the extents of a box-shaped region, you can provide the lower-left and upper-right co-ordinates "{lng1},{lat1},{lng2},{lat2}" as a string or you can provide them as an array [[{lng1},{lat1}],[{lng2},{lat2}]] box parameter.Example: Return listings within a boxhttps://rets.io/api/v2/dataset_id/listings?access_token=access_token&box=-122.435676,37.781368,-122.415764,37.799580
poly stringIf you know the extents of a polygonal region, you can provide the each point as co-ordinates "{lng-1},{lat-1},{lng-2},{lat-2}...{lng-n},{lat-n}" as a string or you can provide them as an array [[{lgn-1},{lat-2}],[{lng-2},{lat-2}]]....,[{lng-n},{lat-n}]] poly parameter.Example: Return listings within a box-shapehttps://rets.io/api/v2/dataset_id/listings?access_token=access_token&poly=-122.435676,37.781368,-122.415764,37.799580,-122.447092,37.796291
groupBy stringThis is only available for summary data (see the /summary parameter).Example: Return summary data for houses with a price greater than $500,000, grouped by year builthttps://rets.io/api/v2/dataset_id/listings/summary?access_token=access_token&price.gt=500000&groupBy=yearBuilt

MLS data

These resources relate to listing data, directly from the MLS. This data is updated as often as each MLS allows. The response schema returns normalized data from all available datasets. For a full list of response fields, please see the Reference section for each resource in the API Explorer.

Multi-MLS development

The Bridge API organizes resources within individual datasets. Should you require data from multiple MLSs, you will need to make separate calls for each dataset.

MLS data resources

/datasets

Retrieve a group of datasets.

Example: Get a list of all datasets approved for an applicationhttps://rets.io/api/v2/datasets?access_token=access_token
/listings

Retrieves a set of listings.

Example: Get listings in the Test dataset where price is greater than $500,000https://rets.io/api/v2/dataset_id/listings?access_token=access_token&price.gt=500000
/agents

Retrieves a set of agents.

Example: Get a set of agents in the Test dataset whose name is not 'Ursula'https://rets.io/api/v2/dataset_id/agents?access_token=access_token&firstName.ne=Ursula
/offices

Retrieves a set of offices.

Example: Get a set of offices in the Test dataset that are located in Vermont https://rets.io/api/v2/dataset_id/offices?access_token=access_token&state=VT
/maps

With a high query limit of 10,000 items, /maps provides a more performant and efficient query method if coordinates are all you need

Example: Get summary data for houses built in 1970https://rets.io/api/v2/dataset_id/listings/maps?access_token=access_token&limit=10
/summary

Retrieves aggregate summary data for a given query.

Example: Get summary data for houses built in 1970https://rets.io/api/v2/dataset_id/listings/summary?access_token=access_token&yearBuilt.gt=1970

SDKs

To help integrate with the Bridge API, various SDKs are available. They are all hosted on GitHub and are open source. If you'd like to contribute, we welcome pull-requests! Currently available SDKs:

RESO OData API

The Bridge platform also allows you to query MLS data using the RESO OData Web API spec.

Operators

You can constrain the result set of a resource by passing additional operators with your request. Valid operators include:

OperatorDescription
eq Equal
ne Not equal
gt Greater than
lt Less than
ge Greater than or equal
le Less than or equal
and Logical and
or Logical or
not Logical not

Parameters

The following query parameters may be passed to narrow down your results. Over time, more fields and aggregation options will be added and more resources will be supported. Depending on the resource, some parameters may be required or unavailable.

Note that geographic coordinates should be ordered {Lng},{Lat} and contain a decimal.

Path Parameters
NameTypeDescription
access_token stringToken to identify the application. This is always required.Example request: return all datasets approved for an applicationhttps://rets.io/api/v2/OData/DataSystem?access_token=Access Token
ListingKey stringThe listing key, available on the /Properties resource.Example: return data relating to a specific listinghttps://rets.io/api/v2/OData/dataset_id/Properties('ListingKey')?access_token=Access Token
MemberKey stringThe member key, available on the /Members resource.Example: Return data relating to a specific agenthttps://rets.io/api/v2/OData/dataset_id/Members('MemberKey')?access_token=Access Token
OfficeKey stringThe office key, available on the /Offices resource.Example: Return data relating to a specific officehttps://rets.io/api/v2/OData/dataset_id/Offices('OfficeKey')?access_token=Access Token
OpenHouseKey stringThe openhouse key, available on the /OpenHouses resource.Example: Return data relating to a specific openhousehttps://rets.io/api/v2/OData/dataset_id/OpenHouses('OpenHouseKey')?access_token=Access Token
Query parameters
NameTypeDescription
$skip numberSkips this number of results.Example: Skip the first 10 listings of the Test datasethttps://rets.io/api/v2/OData/dataset_id/Properties?access_token=access_token&$skip=10
$select stringSelect the fields to be returnedExample: Only return the LivingArea fieldhttps://rets.io/api/v2/OData/dataset_id/Properties?access_token=access_token&$select=LivingArea
$filter stringFilter the results to be returnedExample: Only return the listings where the ListPrice is greater than $100000https://rets.io/api/v2/OData/dataset_id/Properties?access_token=access_token&$filter=ListPrice gt 100000
$top numberLimits the size of the result set. Default is 10.Example: Limit results from the Test dataset to only 2https://rets.io/api/v2/OData/dataset_id/Properties?access_token=access_token&$top=2
$orderby stringResponse field to sort query by.Example: Sort order by descending pricehttps://rets.io/api/v2/OData/dataset_id/Properties?access_token=access_token&$orderby=ListPrice desc
Query Functions
FunctionDescription
geo.distance Search by coordinatesExample: Return listings that are near specific co-ordinates, to a radius of 0.5 mileshttps://rets.io/api/v2/OData/dataset_id/Properties?access_token=access_token&$filter=geo.distance(Coordinates, POINT(-118.62 34.22)) lt 0.5
geo.intersects If you know the extents of a polygonal region, you can provide the each point as co-ordinatesExample: Return listings within a shapehttps://rets.io/api/v2/OData/dataset_id/Properties?access_token=access_token&$filter=geo.intersects(Coordinates, POLYGON((-127.02 45.08,-127.02 45.38,-127.32 45.38,-127.32 45.08,-127.02 45.08)))
tolower Search fields with lowercase queriesExample: Return listings using a lowercase queryhttps://rets.io/api/v2/OData/dataset_id/Properties?access_token=access_token&$filter=tolower(StandardStatus) eq 'active'
toupper Search fields with uppercase queriesExample: Return listings using a uppercase queryhttps://rets.io/api/v2/OData/dataset_id/Properties?access_token=access_token&$filter=toupper(StandardStatus) eq 'ACTIVE'
date Search fields by dateExample: Return listings with a specific datehttps://rets.io/api/v2/OData/dataset_id/Properties?access_token=access_token&$filter=date(ModificationTimestamp) eq 2017-08-29
time Search fields by timeExample: Return listings with a specific timehttps://rets.io/api/v2/OData/dataset_id/Properties?access_token=access_token&$filter=time(ModificationTimestamp) eq 17:03:04
year Search fields by yearExample: Return listings with a specific yearhttps://rets.io/api/v2/OData/dataset_id/Properties?access_token=access_token&$filter=year(ModificationTimestamp) eq 2017
month Search fields by monthExample: Return listings with a specific monthhttps://rets.io/api/v2/OData/dataset_id/Properties?access_token=access_token&$filter=month(ModificationTimestamp) eq 12
day Search fields by dayExample: Return listings with a specific dayhttps://rets.io/api/v2/OData/dataset_id/Properties?access_token=access_token&$filter=day(ModificationTimestamp) eq 23
hour Search fields by hourExample: Return listings with a specific hourhttps://rets.io/api/v2/OData/dataset_id/Properties?access_token=access_token&$filter=hour(ModificationTimestamp) eq 17
minute Search fields by minuteExample: Return listings with a specific minutehttps://rets.io/api/v2/OData/dataset_id/Properties?access_token=access_token&$filter=minute(ModificationTimestamp) eq 50
second Search fields by secondExample: Return listings with a specific secondhttps://rets.io/api/v2/OData/dataset_id/Properties?access_token=access_token&$filter=second(ModificationTimestamp) eq 12
fractionalseconds Search fields by fractionals of secondsExample: Return listings within a specific fraction of a secondhttps://rets.io/api/v2/OData/dataset_id/Properties?access_token=access_token&$filter=fractionalseconds(ModificationTimestamp) eq 123
now() Search fields by current timestampExample: Return listings within the current timestamphttps://rets.io/api/v2/OData/dataset_id/Properties?access_token=access_token&$filter=ModificationTimestamp eq now()

Public Records Data

This includes property records, tax assessments, and transaction records for approximately 148,000,000 properties across 3,200 counties throughout the United States. The Public Records dataset retains the same response format and query capabilities as the MLS Data datasets. The full feed of Public Records is available using the pub dataset, which requires access approval by Bridge Interactive.

Parcels

The Parcels resource includes a document for each property in our dataset, whether it's a detached home, a strata lot, a business, a bare land property, or any other kind of property.

Assessments

The Assessments resource includes present and historical property tax assessments. This includes estimated market and taxable values, tax amounts, and information about the property itself.

Transactions

The Transactions resource includes present and historical property transactions. Any type of change to a property's ownership is reflected in the transactions data set, including sale of new and existing properties, title transfers within families, and finance changes (such as a home loan refinance). Transaction coverage varies by county.

Comparables

The comparables endpoint allows you to access a list of parcels that have similar characteristics (e.g. distance, land use code, lot size, recent sales price) to the parcel specified in the query.

Public Records Field Enumerations

The following is a list of possible values for any fields with closed enumerations for the parcels, transactions and assessments resources.

parcels.landUseCode

ValueDescription
AG000 Agricultural General
AG101 Farm (Irrigated Or Dry)
AG102 Dairy Farm
AG103 Poultry Farm
AG104 Ranch
AG105 Range Land, Grazing Land
AG106 Crop Land, Field Crops, Row Crops
AG107 Orchard (Fruit, Nut)
AG108 Vineyard
AG109 Timberland, Forest, Trees
AG110 Wildlife Refuge
AG111 Desert Land, Barren Land
AG112 Pasture, Meadow
AG113 Grove
AG114 Feedlot
AG115 Livestock
AG116 Horticulture, Growing Houses, Ornamental
AG117 Well Site
AG118 Truck Crops
AG119 Reservoir, Water Supply
AG120 Irrigation, Flood Control
AG121 Rural Improved, Nonresidential
AG122 Natural Resources
AG199 Miscellaneous Structures - Agricultural
CM000 Communication
CM100 Cable Tv Station
CM101 Telephone, Telegraph
CM102 Radio, Tv Station
CM103 Microwave Tower, Cellular Tower
CO000 Commercial Office - General
CO101 Commercial/Office/Residential Mixed Used
CO102 Commercial/Industrial Mixed Use
CO103 Professional Building
CO104 Professional Building Multi-Story
CO105 Office Building
CO106 Office Building Multi-Story
CO107 Dental Building
CO108 Medical Building
CO109 Financial Building
CO110 Condominium Offices
CO111 Skyscraper, Highrise
CO112 Common Area - Commercial Office
CO113 Mobile Commercial Units
CR000 Commercial - General
CR101 Retail Store - General
CR102 Multi-Story Store
CR103 Store/Office (Mixed Use)
CR104 Department Store
CR105 Department Store Multi-Story
CR106 Mall, Shopping Center
CR107 Shopping Plaza, Mini-Mall
CR108 Neighborhood Shopping Center, Strip Mall, Enterprise Zone
CR109 Grocery, Supermarket
CR110 Veterinary, Animal Hospital
CR111 Restaurant
CR112 Fast Food, Drive Thru Restaurant
CR113 Take Out Restaurant (Fast Food)
CR114 Bakery
CR115 Bar, Tavern
CR116 Liquor Store
CR117 Convenience Store
CR118 Gas Station
CR119 Service Station - Full Service
CR120 Service Station With Convenience Store
CR121 Truck Stop
CR122 Vehicle Rentals And Vehicle Sales
CR123 Auto Repair, Garage
CR124 Car Wash
CR125 Dry Cleaner, Laundry
CR126 Service Shop
CR127 Florist, Nursery, Greenhouse
CR128 Wholesale Outlet, Discount Store
CR129 Printer - Retail
CR130 Mini-Warehouse, Storage
CR131 Day Care, Preschool
CR132 Hotel
CR133 Motel
CR134 Hotel/Motel
CR135 Hotel Resort
CR136 Casino
CR137 Parking Garage, Parking Structure
CR138 Parking Lot
CR139 Funeral Home, Mortuary
CR140 Stores & Apartments
CR141 Commercial Building, Mail Order, Show Room
CR142 Appliance Store
CR143 Kennel
CR144 Laundromat
CR145 Nightclub, Cocktail Lounge
CR146 Farm Supply & Equipment
CR147 Garden Center, Home Improvement
CR148 Commercial Condominium
CR149 Drug Store Pharmacy
CR150 Bed & Breakfast
CR151 Shopping Center Common Area
EI000 Exempt - Full Or Partial
EI101 Institutional (General)
EI102 Church, Religious, Worship
EI103 Parochial School, Private School
EI104 College, University, Vocational School - Private
EI105 Hospital - Private
EI106 Medical Clinic
EI107 Home (Nursing, Rest, Convalescent, Handicap, Retired)
EI108 Orphanage, Children's Home
EI109 Cemetery
EI110 Crematorium, Mortuary
EI111 Charitable Organization, Fraternal
EI112 Recreational Non-Taxable
EI113 Private Utility
EI114 Indian Land
GV000 Governmental/Public Use - General
GV101 Public School
GV102 College, University - Public
GV103 Military
GV104 Post Office
GV105 Cultural, Historical
GV106 Government Administrative Office
GV107 Emergency
GV108 City, Municipal, Town, Village Owned
GV109 County Owned
GV110 State Owned
GV111 Federal Property
GV112 Hospital - Public
GV113 Welfare, Social Service, Low Income Housing (Exempt)
GV114 Public Health Care Facility
GV115 Community Center
GV116 Public Utility
GV117 Correctional Facility, Jail, Prison, Insane Asylum
GV118 Forest
GV199 Other Exempt Property
HI000 Historical And Cultural General
HI101 Historical Residence
HI102 Historical Retail
HI103 Historical Park, Site
IH000 Industrial Heavy - General
IH101 Distribution Warehouse
IH102 Mining
IH103 Storage Yard
IH104 Distillery, Brewery, Bottling
IH105 Refinery, Petroleum Products
IH106 Mill
IH107 Factory
IH108 Processing Plant
IH109 Lumberyard, Building Materials
IH110 Shipyard, Storage
IH111 Slaughter House, Stockyard
IH112 Waste Disposal, Sewage
IH113 Quarries
IH114 Heavy Manufacturing
IH115 Labor Camp
IH116 Winery
IH117 Chemical Plant
IH118 Foundary, Industrial Plant
IH119 Cannery
IH120 Bulk Storage, Tanks
IH121 Grain Elevator
IH122 Dump Site
IH123 Cold Storage
IH124 Transportation - Industrial
IN000 Industrial - General
IN101 Manufacturing (Light)
IN102 Light Industrial
IN103 Warehouse
IN104 Storage Yard, Open Storage
IN105 Food Packing, Packing Plant
IN106 Assembly Plant
IN107 Food Processing
IN108 Recycling
IN109 Condominium (Industrial)
IN110 Laboratory, Research Facility, R&D Facilty
IN111 Industrial Park
IN112 Multi-Tenant Industrial Building
IN113 Marine Facility, Boat Repairs
IN114 Lumber & Wood Products Mfg
IN115 Paper Product Mfg & Related Products
IN116 Printing & Publishing
IN117 Loft Building
IN118 Construction/Contracting Services
IN119 Common Area (Industrial)
MS000 Miscellaneous
MS101 Pipeline Or Right Of Way
MS102 Rail (Right Of Way & Track)
MS103 Road (Right-Of-Way)
MS104 Utilities (Right Of Way Only)
MS105 Subsurface Rights
MS106 Surface Rights
MS107 Leasehold Rights
MS108 Possessory Interest
MS109 Petroleum & Gas Wells
MS110 Water Rights
MS111 Right Of Way
MS112 Easement
MS113 Homestead
MS114 Common Area
MS115 Royalty Interest
MS116 Working Interest
MS117 Special Purpose
MS118 Sbe Special Assessments
MS119 Regulating District & Assessment Tax Abatement
MS120 Redevelopment Agency Or Zone
MS121 Centrally Assessed
MS199 Improved, Land Use Not Specified
PP000 Personal Property - General
PP101 Business Personal Property
PP102 Watercraft
PP103 Rolling Stock
PP104 Equipment Or Supplies
PP105 Structures General
PP106 Structures On Leased Land
PP107 Misc Personal Property General
PP199 Miscellaneous Structure - Personal Property
RC000 Recreational/Entertainment - General
RC101 Recreation Center
RC102 Public Swimming Pool
RC103 Marina, Yacht Club, Boat Slips, Boat Landing
RC104 Bowling Alley
RC105 Arcade
RC106 Ice Skating Rink, Roller Skating Rink
RC107 Club, Lodge, Professional Association
RC108 Museum, Library, Art Gallery
RC109 Country Club
RC110 Stadium
RC111 Arena, Convention Center
RC112 Auditorium
RC113 Golf Driving Range
RC114 Race Track
RC115 Fitness Center, Gym, Health Spa
RC116 Dance Hall
RC117 Riding Stable, Riding Trail
RC118 Campground, Rv Park
RC119 Fairground
RC120 Theater
RC121 Drive In Theater
RC122 Amphitheater
RC123 Amusement Park, Tourist Attraction
RC124 Pier, Wharf, Dock
RC125 Fish Camp, Game Club, Target Shooting
RC126 Outdoor Recreation: Beach, Mountain, Desert
RC127 Pool Hall, Billiard Parlor
RC128 Park, Playground, Picnic Area
RC129 Golf Course
RC130 Racquet Court, Tennis Court
RC131 Zoo
RC132 Miniature Golf, Water Slide, Go-Cart
RI000 Residential Income General (Multi Family)
RI101 Duplex (2 Units, Any Combination)
RI102 Triplex (3 Units, Any Combination)
RI103 Quadruplex (4 Units, Any Combination)
RI104 Apartment Building (5+ Units)
RI105 Apartment Building (100+ Units)
RI106 Garden Apartment, Court Apartment (5+ Units)
RI107 High-Rise Apartment
RI108 Boarding House Rooming House Apt Hotel Transient Lodging
RI109 Mobile Home Park, Trailer Park
RI110 Multifamily Dwelling (Generic Any Combination 2+)
RI111 Fraternity House, Sorority House
RI112 Apartment (Generic)
RI113 Dormitory, Group Quarters (Residential)
RI114 Residential Condominium Development (Association Assessment)
RR000 Residential General
RR101 Single Family Residential
RR102 Rural Residence
RR103 Mobile Home
RR104 Townhouse
RR105 Cluster Home
RR106 Condominium
RR107 Cooperative
RR108 Row House
RR109 Planned Unit Development
RR110 Residential Common Area
RR111 Timeshare
RR112 Seasonal, Cabin, Vacation Residence
RR113 Bungalow
RR114 Zero Lot Line
RR115 Manufactured, Modular, Prefabricated Homes
RR116 Patio Home
RR117 Residential Parking Garage
RR118 Miscellaneous Improvement
RR999 Inferred Single Family Residential
TR000 Transportation - General
TR101 Airport And Related
TR102 Railroad And Related
TR103 Freeway, State Highway
TR104 Road, Street, Bridge
TR105 Bus Terminal, Bus Station
TR106 Truck Terminal
TR107 Harbor & Marine Transportation
TR108 Commercial Auto Transportation/Storage
TR109 Pollution Control
VL000 Vacant Land - General
VL101 Residential Vacant Land
VL102 Commercial Vacant Land
VL103 Industrial Vacant Land
VL104 Open Space, Conservation, Forest Land
VL105 Institutional Vacant Land
VL106 Government Vacant Land
VL107 Multi-Family Vacant Land
VL108 Agricultural, Unimproved Vacant Land
VL109 Waste Land, Marsh, Swamp, Submerged Vacant Land
VL110 Recreational Vacant Land
VL111 Water Area (Lake, River, Shore)
VL112 Unusable Land
VL113 Abandoned Site, Contaminated Site
VL114 Under Construction
RR119 Garden Home
RR120 Landominium

parcels.landUseDescription

Value
Agricultural General
Farm (Irrigated Or Dry)
Dairy Farm
Poultry Farm
Ranch
Range Land, Grazing Land
Crop Land, Field Crops, Row Crops
Orchard (Fruit, Nut)
Vineyard
Timberland, Forest, Trees
Wildlife Refuge
Desert Land, Barren Land
Pasture, Meadow
Grove
Feedlot
Livestock
Horticulture, Growing Houses, Ornamental
Well Site
Truck Crops
Reservoir, Water Supply
Irrigation, Flood Control
Rural Improved, Nonresidential
Natural Resources
Miscellaneous Structures - Agricultural
Communication
Cable Tv Station
Telephone, Telegraph
Radio, Tv Station
Microwave Tower, Cellular Tower
Commercial Office - General
Commercial/Office/Residential Mixed Used
Commercial/Industrial Mixed Use
Professional Building
Professional Building Multi-Story
Office Building
Office Building Multi-Story
Dental Building
Medical Building
Financial Building
Condominium Offices
Skyscraper, Highrise
Common Area - Commercial Office
Mobile Commercial Units
Commercial - General
Retail Store - General
Multi-Story Store
Store/Office (Mixed Use)
Department Store
Department Store Multi-Story
Mall, Shopping Center
Shopping Plaza, Mini-Mall
Neighborhood Shopping Center, Strip Mall, Enterprise Zone
Grocery, Supermarket
Veterinary, Animal Hospital
Restaurant
Fast Food, Drive Thru Restaurant
Take Out Restaurant (Fast Food)
Bakery
Bar, Tavern
Liquor Store
Convenience Store
Gas Station
Service Station - Full Service
Service Station With Convenience Store
Truck Stop
Vehicle Rentals And Vehicle Sales
Auto Repair, Garage
Car Wash
Dry Cleaner, Laundry
Service Shop
Florist, Nursery, Greenhouse
Wholesale Outlet, Discount Store
Printer - Retail
Mini-Warehouse, Storage
Day Care, Preschool
Hotel
Motel
Hotel/Motel
Hotel Resort
Casino
Parking Garage, Parking Structure
Parking Lot
Funeral Home, Mortuary
Stores & Apartments
Commercial Building, Mail Order, Show Room
Appliance Store
Kennel
Laundromat
Nightclub, Cocktail Lounge
Farm Supply & Equipment
Garden Center, Home Improvement
Commercial Condominium
Drug Store Pharmacy
Bed & Breakfast
Shopping Center Common Area
Exempt - Full Or Partial
Institutional (General)
Church, Religious, Worship
Parochial School, Private School
College, University, Vocational School - Private
Hospital - Private
Medical Clinic
Home (Nursing, Rest, Convalescent, Handicap, Retired)
Orphanage, Children's Home
Cemetery
Crematorium, Mortuary
Charitable Organization, Fraternal
Recreational Non-Taxable
Private Utility
Indian Land
Governmental/Public Use - General
Public School
College, University - Public
Military
Post Office
Cultural, Historical
Government Administrative Office
Emergency
City, Municipal, Town, Village Owned
County Owned
State Owned
Federal Property
Hospital - Public
Welfare, Social Service, Low Income Housing (Exempt)
Public Health Care Facility
Community Center
Public Utility
Correctional Facility, Jail, Prison, Insane Asylum
Forest
Other Exempt Property
Historical And Cultural General
Historical Residence
Historical Retail
Historical Park, Site
Industrial Heavy - General
Distribution Warehouse
Mining
Storage Yard
Distillery, Brewery, Bottling
Refinery, Petroleum Products
Mill
Factory
Processing Plant
Lumberyard, Building Materials
Shipyard, Storage
Slaughter House, Stockyard
Waste Disposal, Sewage
Quarries
Heavy Manufacturing
Labor Camp
Winery
Chemical Plant
Foundary, Industrial Plant
Cannery
Bulk Storage, Tanks
Grain Elevator
Dump Site
Cold Storage
Transportation - Industrial
Industrial - General
Manufacturing (Light)
Light Industrial
Warehouse
Storage Yard, Open Storage
Food Packing, Packing Plant
Assembly Plant
Food Processing
Recycling
Condominium (Industrial)
Laboratory, Research Facility, R&D Facilty
Industrial Park
Multi-Tenant Industrial Building
Marine Facility, Boat Repairs
Lumber & Wood Products Mfg
Paper Product Mfg & Related Products
Printing & Publishing
Loft Building
Construction/Contracting Services
Common Area (Industrial)
Miscellaneous
Pipeline Or Right Of Way
Rail (Right Of Way & Track)
Road (Right-Of-Way)
Utilities (Right Of Way Only)
Subsurface Rights
Surface Rights
Leasehold Rights
Possessory Interest
Petroleum & Gas Wells
Water Rights
Right Of Way
Easement
Homestead
Common Area
Royalty Interest
Working Interest
Special Purpose
Sbe Special Assessments
Regulating District & Assessment Tax Abatement
Redevelopment Agency Or Zone
Centrally Assessed
Improved, Land Use Not Specified
Personal Property - General
Business Personal Property
Watercraft
Rolling Stock
Equipment Or Supplies
Structures General
Structures On Leased Land
Misc Personal Property General
Miscellaneous Structure - Personal Property
Recreational/Entertainment - General
Recreation Center
Public Swimming Pool
Marina, Yacht Club, Boat Slips, Boat Landing
Bowling Alley
Arcade
Ice Skating Rink, Roller Skating Rink
Club, Lodge, Professional Association
Museum, Library, Art Gallery
Country Club
Stadium
Arena, Convention Center
Auditorium
Golf Driving Range
Race Track
Fitness Center, Gym, Health Spa
Dance Hall
Riding Stable, Riding Trail
Campground, Rv Park
Fairground
Theater
Drive In Theater
Amphitheater
Amusement Park, Tourist Attraction
Pier, Wharf, Dock
Fish Camp, Game Club, Target Shooting
Outdoor Recreation: Beach, Mountain, Desert
Pool Hall, Billiard Parlor
Park, Playground, Picnic Area
Golf Course
Racquet Court, Tennis Court
Zoo
Miniature Golf, Water Slide, Go-Cart
Residential Income General (Multi Family)
Duplex (2 Units, Any Combination)
Triplex (3 Units, Any Combination)
Quadruplex (4 Units, Any Combination)
Apartment Building (5+ Units)
Apartment Building (100+ Units)
Garden Apartment, Court Apartment (5+ Units)
High-Rise Apartment
Boarding House Rooming House Apt Hotel Transient Lodging
Mobile Home Park, Trailer Park
Multifamily Dwelling (Generic Any Combination 2+)
Fraternity House, Sorority House
Apartment (Generic)
Dormitory, Group Quarters (Residential)
Residential Condominium Development (Association Assessment)
Residential General
Single Family Residential
Rural Residence
Mobile Home
Townhouse
Cluster Home
Condominium
Cooperative
Row House
Planned Unit Development
Residential Common Area
Timeshare
Seasonal, Cabin, Vacation Residence
Bungalow
Zero Lot Line
Manufactured, Modular, Prefabricated Homes
Patio Home
Residential Parking Garage
Miscellaneous Improvement
Inferred Single Family Residential
Transportation - General
Airport And Related
Railroad And Related
Freeway, State Highway
Road, Street, Bridge
Bus Terminal, Bus Station
Truck Terminal
Harbor & Marine Transportation
Commercial Auto Transportation/Storage
Pollution Control
Vacant Land - General
Residential Vacant Land
Commercial Vacant Land
Industrial Vacant Land
Open Space, Conservation, Forest Land
Institutional Vacant Land
Government Vacant Land
Multi-Family Vacant Land
Agricultural, Unimproved Vacant Land
Waste Land, Marsh, Swamp, Submerged Vacant Land
Recreational Vacant Land
Water Area (Lake, River, Shore)
Unusable Land
Abandoned Site, Contaminated Site
Under Construction
Garden Home
Landominium

parcels.landUseGeneral

ValueDescription
AG Agricultural
CM Commercial
CO Commercial Office - General
CR Commercial - General
EI Exempt - Full Or Partial
GV Government
HI Historical And Cultural General
IH Industrial Heavy - General
IN Industrial
MS Miscellaneous
PP Personal Property - General
RC Recreational
RI Residential Income General (Multi Family)
RR Residential
TR Transportation - General
VL Vacant Land/Lot

parcels.building.quality

Value
A
A+
A-
B
B+
B-
C
C+
C-
D
D+
D-
E
E+
E-

parcels.building.water

Value
Cistern
Municipal/Public
None
Spring
Well
Yes, but not specified

parcels.building.sewer

Value
None
Municipal/Public
Septic
Storm
Yes, but not specified

parcels.building.airConditioning

Value
Central
Chilled Water
Evaporative Cooler
Geo Thermal
None
Other
Packaged AC Unit
Partial
Refrigeration
Ventilation
Wall Unit
Window Unit
Yes

parcels.building.fireplace

Value
Electric
Free Standing
Gas
Gel
Masonry
Modern
Portable
Wall Mounted
Wood

parcels.building.foundation

Value
Concrete
Concrete Block
Crawl Space/Raised
Crossed Walls
Earth/Soil
Footing
Masonry
Mud Sill
Other
Pilings
Piers
Raised Foundation
Retaining Wall
Slab
Stone
Wood

parcels.building.heating

Value
Baseboard
Central
Coal
Convection
Electric
Forced air
Floor/Wall
Gas
Geo Thermal
Gravity
Heat Pump
Hot Water
None
Other
Oil
Partial
Propane
Radiant
Steam
Solar
Space/Suspended
Vent
Wood Burning
Yes
Zone

parcels.building.occupancyStatus

Value
Assumed Owner Occupancy
Homestead Property
Owner Occupied or Primary Residence
Second Home

parcels.garages.garageType

Value
Attached
Underground/basement
Built in
Carport
Covered
Detached
Finished
Garage
Open
Pole
Mixed
None
Offsite
Parking lot
Parking structure
Paved/Surfaced
Ramp
RV Parking Space
Tuckunder
Underground
Unimproved
Unfinished
Yes

parcels.pools.poolType

Value
Above ground pool
Pool with Spa/Hot Tub
Community pool or spa
Enclosed pool
Indoor swimming pool
Vinyl in-ground pool
Pool
Heated Pool
Solar Heated Pool
Spa or Hot Tub (only)

parcels.areas.areaType

Value
Garage Apartment
Apartment
Attic
Attic Finished
Attic Unfinished
Base Building Area
Effective Building Area
Finished Building Area
Gross Building Area
Heated Building Area
Adjusted Building Area
Living Building Area
Perimeter Building Area
Manufacturing
Total Building Area
Basement Full Daylight
Breakfast Nook
Balcony/Overhang
Basement Partial Daylight
Basement Full
Basement Finished
No Basement
Basement Partial
Bonus Room
Basement Unfinished
Basement
Breezeway
Canopy/Awning
Family Room/Den
Exercise Room
Game Room/Recreation
Great Room
Media Room/Home Theater
Lanai
Study/Library
Lobby/Vestibule
Loft
Loft Garage
Laundry Room
Mezzanine
Office
Portico (Drive Under)
Covered Porch
Enclosed Porch
Glass Enclosed Porch
Porch
Open Porch
Screened Porch
Sun Room
Floor 1
Floor 2
Floor 3
Floor 4
Floor 5
Floor 6
Floor 7
Floor 8
Floor 9
Half Story, 3/4 Story
Lower Level
Upper Story
Utility/Storage Room
Atrium
Living Building Area Finished
Living Building Area Unfinished
Cellar
Hobby/Craft/Sewing
Mud Room
Sitting Room
Floor 1 Finished
Upper Story Finished
Upper Story Unfinised
Carport
Garage

transactions.documentTypeID

ValueDescription
1 Administrators Deed
2 Affidavit - Death of Tenant by Entirety
3 Affidavit - Death of Life Tenant
4 Affidavit - Death of Trustee/Successor Trustee (Los Angeles County only)
5 Affidavit - Death of Joint Tenant
6 Affidavit
7 Affidavit of Publication of Notice of Sale
8 Affidavit - Surviving Joint Tenant
9 Affidavit - Surviving Spouse
10 Affidavit - Survivorship
11 Affidavit - Transfer on Death
12 Affidavit of Trust or Trust Agreement (Los Angeles County only)
13 Agreement of Sale (Agreement for Deed)
14 Assumption Deed/Agreement
15 Assignment of Commercial Lease
16 Assignment of Certificate of Purchase
17 Assignment of Certificate of Sale
18 Assignment of Contract of Sale
19 Assignment Deed
20 Assignment of Land Contract
21 Assignment of Lease (Leasehold Sale)
22 Assignment of Sub Agreement of Sale
23 Assignment of Sub Lease
24 Assignment of Sub Commercial Lease
25 Assignment of Agreement of Sale
26 Beneficiary Deed
27 Bargain & Sale Deed
28 Condominium Deed
29 Certificate of Purchase (Public Trustee's Certificate of Purchase)
30 Certificate of Redemption
31 Certificate of Sale
32 Certificate of Title
33 Certificate of Transfer
34 Cash Sale Deed
35 Commissioner's Assignment of Lease
36 Commissioners Deed
37 Commercial Lease
38 Cancellation of Agreement of Sale
39 Cancellation of Contract of Sale
40 Cancellation of Notice of Default
41 Cancellation of Land Contract
42 Cancellation of Lis Pendens
43 Cancellation of Notice of Sale
44 Cancellation of Notice of Sale (Trustee Sale, Sheriff Sale or Foreclosure Sale)
45 Cancellation of Trustees Deed
46 Court Order/Action
47 Confirmation Deed
48 Corporation Deed
49 Correction Deed
50 Contract of Sale
51 Conservators Deed
52 Declaration
53 Deed of Distribution
54 Deed
55 Deed in Lieu of Foreclosure
56 Deed Under Power of Sale
57 Distress Sale
58 Estoppel Deed
59 Exchange
60 Executors Deed/Executrixs Deed
61 Foreclosure Auction - Status Sold
62 Foreclosure Deed/Certificate
63 Fiduciary Deed
64 Guardians Deed
65 Gift Deed
66 Grant Deed
67 Ground Lease
68 Gift Warranty Deed
69 Satisfaction of Agreement of Sale (Hawaii - Leasehold)
70 Satisfaction of Agreement of Sale (Hawaii - Fee property)
71 Individual Deed
72 Intrafamily Transfer & Dissolution
73 Interspousal Transfer Deed
74 Judgment of Foreclosure
75 Judgment
76 Joint Tenancy Deed
77 Leasehold Conversion with Agreement of Sale (Fee Purchase)
78 Leasehold Conversion with Agreement of Sale
79 Land Court (Massachusetts)
80 Land Contract
81 Lease
82 Life Estate Deed/Deed Reserving Life Estate
83 Life Estate Quitclaim Deed
84 Life Estate Warranty Deed
85 Leasehold
86 Limited Warranty Deed
87 Limited Warranty Deed with Vendors Lien
88 Mobile Home Title
89 Marshalls Deed
90 Deed of Trust/Mortgage
91 Newly Filed Complaint/Petition to Foreclose
92 Non-Warranty Deed
93 Notice of Default
94 Notice of Lis Pendens
95 Notice of Sale (Trustee Sale, Sheriff Sale or Foreclosure Sale)
96 Order of Dismissal
97 Other
98 Power of Attorney to Foreclose Mortgage
99 Partial Cancellation of Notice of Default
100 Partial Cancellation of Lis Pendens
101 Personal Representatives Deed
102 Partnership Deed
103 Public Auction
104 Quitclaim Deed
105 Receivers Deed
106 Redemption Deed
107 REO Sale (REO Out)
108 Referees Deed
109 Re-Recorded Deed
110 Revocation of Beneficiary Deed
111 Revocation of Transfer on Death
112 Sub Agreement of Sale
113 Sub Commercial Lease
114 Sub Lease
115 Satisfaction of Agreement of Sale
116 Satisfaction of Contract of Sale
117 Satisfaction of Land Contract
118 Sheriffs Certificate of Sale
119 Sheriffs Deed
120 Sheriffs Tax Deed
121 Sale Change (Rescheduled or Postponed)
122 Sale Cancelled
123 Special Limited Warranty Deed with Vendors Lien
124 Special Limited Warranty Deed
125 Special Joint Tenancy Warranty Deed
126 Special Masters Deed
127 Special Warranty Deed with Vendors Lien
128 Special Warranty Deed
129 Survivorship Deed
130 Termination of Decedent's Property Interest
131 Transfer on Death Deed
132 Trustees Deed (non-foreclosure)
133 Trustees Deed (foreclosure sale transfer)
134 Transaction History Record
135 Treasurers Deed
136 Tax Deed
137 Vendors Lien Deed
138 Warranty Deed
139 Warranty Leasehold Estate Deed
140 Warranty Deed with Vendors Lien
141 Assessor Sales History Document
142 Assumption Warranty Deed
143 Conservator's Warranty Deed
144 Gift Grant Deed
145 Gift Warranty Deed
146 Master in Equity's Deed
147 Redemption Quit Claim Deed
148 Special Referee's Deed
149 Survivorship Warranty Deed

transactions.documentType

Valuedescription
1 Administrators Deed
2 Affidavit - Death of Tenant by Entirety
3 Affidavit - Death of Life Tenant
4 Affidavit - Death of Trustee/Successor Trustee (Los Angeles County only)
5 Affidavit - Death of Joint Tenant
6 Affidavit
7 Affidavit of Publication of Notice of Sale
8 Affidavit - Surviving Joint Tenant
9 Affidavit - Surviving Spouse
10 Affidavit - Survivorship
11 Affidavit - Transfer on Death
12 Affidavit of Trust or Trust Agreement (Los Angeles County only)
13 Agreement of Sale (Agreement for Deed)
14 Assumption Deed/Agreement
15 Assignment of Commercial Lease
16 Assignment of Certificate of Purchase
17 Assignment of Certificate of Sale
18 Assignment of Contract of Sale
19 Assignment Deed
20 Assignment of Land Contract
21 Assignment of Lease (Leasehold Sale)
22 Assignment of Sub Agreement of Sale
23 Assignment of Sub Lease
24 Assignment of Sub Commercial Lease
25 Assignment of Agreement of Sale
26 Beneficiary Deed
27 Bargain & Sale Deed
28 Condominium Deed
29 Certificate of Purchase (Public Trustee's Certificate of Purchase)
30 Certificate of Redemption
31 Certificate of Sale
32 Certificate of Title
33 Certificate of Transfer
34 Cash Sale Deed
35 Commissioner's Assignment of Lease
36 Commissioners Deed
37 Commercial Lease
38 Cancellation of Agreement of Sale
39 Cancellation of Contract of Sale
40 Cancellation of Notice of Default
41 Cancellation of Land Contract
42 Cancellation of Lis Pendens
43 Cancellation of Notice of Sale
44 Cancellation of Notice of Sale (Trustee Sale, Sheriff Sale or Foreclosure Sale)
45 Cancellation of Trustees Deed
46 Court Order/Action
47 Confirmation Deed
48 Corporation Deed
49 Correction Deed
50 Contract of Sale
51 Conservators Deed
52 Declaration
53 Deed of Distribution
54 Deed
55 Deed in Lieu of Foreclosure
56 Deed Under Power of Sale
57 Distress Sale
58 Estoppel Deed
59 Exchange
60 Executors Deed/Executrixs Deed
61 Foreclosure Auction - Status Sold
62 Foreclosure Deed/Certificate
63 Fiduciary Deed
64 Guardians Deed
65 Gift Deed
66 Grant Deed
67 Ground Lease
68 Gift Warranty Deed
69 Satisfaction of Agreement of Sale (Hawaii - Leasehold)
70 Satisfaction of Agreement of Sale (Hawaii - Fee property)
71 Individual Deed
72 Intrafamily Transfer & Dissolution
73 Interspousal Transfer Deed
74 Judgment of Foreclosure
75 Judgment
76 Joint Tenancy Deed
77 Leasehold Conversion with Agreement of Sale (Fee Purchase)
78 Leasehold Conversion with Agreement of Sale
79 Land Court (Massachusetts)
80 Land Contract
81 Lease
82 Life Estate Deed/Deed Reserving Life Estate
83 Life Estate Quitclaim Deed
84 Life Estate Warranty Deed
85 Leasehold
86 Limited Warranty Deed
87 Limited Warranty Deed with Vendors Lien
88 Mobile Home Title
89 Marshalls Deed
90 Deed of Trust/Mortgage
91 Newly Filed Complaint/Petition to Foreclose
92 Non-Warranty Deed
93 Notice of Default
94 Notice of Lis Pendens
95 Notice of Sale (Trustee Sale, Sheriff Sale or Foreclosure Sale)
96 Order of Dismissal
97 Other
98 Power of Attorney to Foreclose Mortgage
99 Partial Cancellation of Notice of Default
100 Partial Cancellation of Lis Pendens
101 Personal Representatives Deed
102 Partnership Deed
103 Public Auction
104 Quitclaim Deed
105 Receivers Deed
106 Redemption Deed
107 REO Sale (REO Out)
108 Referees Deed
109 Re-Recorded Deed
110 Revocation of Beneficiary Deed
111 Revocation of Transfer on Death
112 Sub Agreement of Sale
113 Sub Commercial Lease
114 Sub Lease
115 Satisfaction of Agreement of Sale
116 Satisfaction of Contract of Sale
117 Satisfaction of Land Contract
118 Sheriffs Certificate of Sale
119 Sheriffs Deed
120 Sheriffs Tax Deed
121 Sale Change (Rescheduled or Postponed)
122 Sale Cancelled
123 Special Limited Warranty Deed with Vendors Lien
124 Special Limited Warranty Deed
125 Special Joint Tenancy Warranty Deed
126 Special Masters Deed
127 Special Warranty Deed with Vendors Lien
128 Special Warranty Deed
129 Survivorship Deed
130 Termination of Decedent's Property Interest
131 Transfer on Death Deed
132 Trustees Deed (non-foreclosure)
133 Trustees Deed (foreclosure sale transfer)
134 Transaction History Record
135 Treasurers Deed
136 Tax Deed
137 Vendors Lien Deed
138 Warranty Deed
139 Warranty Leasehold Estate Deed
140 Warranty Deed with Vendors Lien
141 Assessor Sales History Document
142 Assumption Warranty Deed
143 Conservator's Warranty Deed
144 Gift Grant Deed
145 Gift Warranty Deed
146 Master in Equity's Deed
147 Redemption Quit Claim Deed
148 Special Referee's Deed
149 Survivorship Warranty Deed

transactions.recordType

Value
Multi-APN Record
Buyer Addendum Record
Borrower Addendum Record
Grantee Notes Addendum Record (Hawaii)
Primary Record
Borrower Vesting Addendum Record
Seller Addendum Record
Multi-Unit Record (Hawaii)
Buyer Vesting Addendum
Borrower Notes Addendum Record (Hawaii)

transactions.lenderType

Value
Bank
Credit Union
Et Al
Finance company
Government entity
Insurance company
Internet Storefront
Lending company
Mortgage company
Not Provided
Other
Private Party
REO/Foreclosure Company
Reverse Mortgage Lender
Subprime Lender
Seller
Unknown
Undisclosed

transactions.partialInterestTransfer

Value
Multiple parcels conveyed with at least one parcel being conveyed at 100% ownership interest, the others are different interest less than 100%
Multiple parcels conveyed with differing ownership interest each being less than 100%
Known partial interest transfer, actual percentage reported in field Partial Interest Transfer percent field.
Unsure whether transfer is partial interest
Known partial interest transfer, actual percentage unknown.

transactions.borrowerVesting

Value
Community (Marital) Property
Community Property with Rights of Survivorship
Domestic Partner Sole and Separate Property
Et Al
Et Ux
Joint Tenancy With Rights Of Survivorship
Joint Tenancy (may be reported as Joint Tenancy with Right of Survivorship)
Joint Venture
Life Estate
Married Man Sole and Separate Property
Ownership in Severalty (Tenancy in Severalty)
Right of Survivorship
Survivorship Marital Property
Sole and Separate Property
Tenancy in Common
Tenancy by the Entirety (may be reported as Tenancy by the Entirety with full right of survivorship)
Married Woman Sole and Separate Property
Estate
Family Living Trust
Family Trust
Family Revocable Trust
Irrevocable Living Trust
Irrevocable Trust
Living Trust
Revocable Living Trust
Revocable Trust
Trust

transactions.loanAmountDescription

Value
Aggregate amount (multiple loans with an aggregate total provided)
Calculated Loan amount (multiple amounts reported on document)
Multiple Loan Amounts
Loan amount not reported on recorded document
Assumed loan amount

Zestimates

This API will return all current Property and Rental Zestimates available on Zillow.com. Note that not all properties will have associated Zestimates. You are able to query by any fields that are returned in the response bundle.

Valid operators include:

OperatorDescription
eq equal
ne not equal
gt greater than
lt less than
gte greater than or equal
lte less than or equal
in comma-separated list, equal only
Query parameters
NameTypeDescription
offset numberSkips this number of results.Example: Skip the first 10 resultshttps://rets.io/api/v2/zestimates?access_token=access_token&offset=10
limit numberLimits the size of the result set. Default is 10.Example: Limit results from to only 2https://rets.io/api/v2/zestimates?access_token=access_token&limit=2
near stringCoord or location e.g. near={Lng},{Lat} or near=San DiegoExample: Return Zestimates that are near specific co-ordinateshttps://rets.io/api/v2/zestimates?access_token=access_token&limit=2&near=-122.395743,37.793662
radius stringRadius to search within. Can be suffixed with units mi(miles) or km(kilometer). Miles are default.Example: Return Zestimates that near to specific co-ordinants, constrained 5 mileshttps://rets.io/api/v2/zestimates?access_token=access_token&limit=2&near=-122.395743,37.793662&radius=5mi
box stringIf you know the extents of a box-shaped region, you can provide the lower-left and upper-right co-ordinates "{lng1},{lat1},{lng2},{lat2}" as a string or you can provide them as an array [[{lng1},{lat1}],[{lng2},{lat2}]] box parameter.Example: Return Zestimates within a boxhttps://rets.io/api/v2/zestimates?access_token=access_token&box=-122.435676,37.781368,-122.415764,37.799580
poly stringIf you know the extents of a polygonal region, you can provide the each point as co-ordinates "{lng-1},{lat-1},{lng-2},{lat-2}...{lng-n},{lat-n}" as a string or you can provide them as an array [[{lgn-1},{lat-2}],[{lng-2},{lat-2}]]....,[{lng-n},{lat-n}]] poly parameter.Example: Return Zestimates within a box-shapehttps://rets.io/api/v2/zestimates?access_token=access_token&poly=-122.435676,37.781368,-122.415764,37.799580,-122.447092,37.796291
Usage examples

Query Zestimate by address

https://rets.io/api/v2/zestimates?access_token=access_token&address=1234 N Main Street Tuscon AZ 85494

Query by list of ZPIDs

https://rets.io/api/v2/zestimates?access_token=access_token&zpid.in=123456,54321,15243

Query by Rental Zestimates greater than 1000

https://rets.io/api/v2/zestimates?access_token=access_token&rental.zestimate.gt=1000

Bridge API Secure Sign-in OAuth Flow

Bridge API uses the OAuth2 protocol for authorization. OAuth provides client applications a 'secure delegated access' to server resources on behalf of a resource owner. It specifies a process for resource owners to authorize third-party access to their server resources without sharing their credentials.

In some cases, MLSs may require that your application authenticates your user as an active member of that organization. The Bridge API Secure Sign-In OAuth flow is designed to facilitate authenticating Agents against MLS datasets by allowing them to create and sign-in to a Bridge API account and authorize your application.

Setting up an OAuth flow

The OAuth domain and redirect URI must be specified on the Bridge API platform (found on your application's setup page).

Once a flow has been setup, a user will be able to sign in to their Bridge API account to authorize data access. If they have not previously setup a Bridge API account, they can do so via the flow dialog. To setup an account your user must first validate their email address (by selecting their MLS, and enter the email used on that database), entering the validation code that is emailed to them, and selecting a password. After the account has been created, they can sign in.

Once signed in, the user will be prompted to authorize data access on their behalf for your application, and if scope permissions have been set by the data provider, they will need to approve each scope.

Setting up the OAuth flow is best understood as being comprised of three steps:

  • Initialization: The application making the request is verified, initial conditions are set.

  • Authorization: A decision is (or is not) displayed to the user, who then decides whether or not to authorize the OAuth Client.

  • Return: OAuth credential is (or is not) returned to the OAuth Client with accompanying information (state, expiry, etc).

Initialization

Initialization determines what is displayed to the user, the type of credential (authorization token) returned, and the way in which that credential is returned.

Note If you provide invalid values for initialization parameters other than those detailed below, the values will be stripped and ignored.

An example OAuth initialization request:
https://rets.io/oauth/authorize
  ?client_id={client_id}
  &redirect_uri={redirect_uri}
  &response_type=code
  &scope=offline pub
  &state=hardToGuessNonce
  &dialog=true
  &reprompt=true
  &dataset={test test_sf test_sd}

Required parameters

ParameterTypeDescription
client_idstringYour application's unique identifier, and can be found on your application's details and settings pages. Your application has to be approved for any datasets that you are attempting to authorize against.
redirect_uristringDesignates where the result (credential or error) is sent after the completion of the flow. This must match the Redirect URL specified in your application settings.
response_typestringAccepts either token or code. Determines whether a simple authorization token is returned, or a validation code. For additional security, we recommend using code, as authorization tokens will not be exposed. If code is specified, you will need to do a code exchange to receive the token (see Code Exchange below).
datasetstringAccepts space separated datasetIDs. This parameter is used to control the MLS datasets that are displayed in the Secure Sign-In's user registration process. If no dataset is specified, the dropdown will populate with all the MLS datasets currently approved for your application. This parameter will also pre-populate the flow dialog with the MLS's logo, which is helpful in establishing user trust. Only MLS datasets that have been approved for your application are available.

Optional parameters

ParameterTypeDescription
scopestringAccepts offline. The offline scope, which is only effective during response_type=code flow, grants a long-lived token and a refresh token, giving the application access to the dataset on behalf of the user beyond the lifetime of a normal session (a normal session is 3 hours).
statestringA single-use string that you may implement, and will be passed back at the end of the flow. The state parameter can help you secure against the possibility of cross-site request forgery.
dialogbooleanIndicates the manner in which credentials should be returned. If set to true, the result will be an object passed via postMessage to the redirect_uri. This will open a new window in which the Bridge API Secure Sign-In OAuth flow will be displayed. Unless set to true the resultant credential is passed back to the redirect_uri via the address.
repromptbooleanDefines whether the user is reprompted for previously unauthorized scopes.
iconbooleanIndicates whether the app icon should appear on each page of the OAuth flow.
autoPopulatestringAccepts space separated field names. Indicates whether the user registration page should auto fill-in the specified fields based on MLS agent data. The options for field names are: firstName, lastName, office, and email.

Authorization

Once a user has signed in to their Bridge API account, they are required to authorize data access. This part of the flow determines whether your user needs to be prompted with a decision.

There are several scenarios where a user will be prompted for authorization confirmation:

Initial authorization:

  • If the user has not previously authorized the OAuth client.

When initialized with reprompt = true:

  • If, during a previous decision, the user decided to not grant all requested permissions.
  • If the requesting OAuth Client has gained access to new datasets.
  • If the user has different associations since they last authorized.

Subsequent to the initial authorization, the user will only be reprompted to authorize additional scopes if the OAuth Client has passed the reprompt option during the initialization phase and if there is any difference between previously authorized and currently requested scopes. If the OAuth Client did not include reprompt=true, if there is no difference in granted and requested scope or if none of the above reprompt scenarios apply, the decision prompt is not seen by the user and the OAuth Client is sent appropriate credentials.

Displayed scopes

The scopes that are displayed to your user for authorization are dependent on the datasets the application has been approved for, and the scopes that have been approved by the data provider for each of those datasets.

Return

The final step in the flow returns authorization credentials, taking into account the initialization parameters response_type, state and dialog.

Initialization responses

ResponseDescription
401 Invalid ClientThe specified Client ID is not correct. Check your application's Client ID, available on your application's detail and settings pages.
400 Redirect URI requiredThe Redirect URL is missing.
400 Redirect URI mismatchThe Redirect URI does not match the URL specified in your application's settings page.
400 Invalid response_typeResponse type can only be token or code.

Authorization responses

ResponseDescription
401 The user denied authorizationYour user has denied your application access to the dataset during their OAuth flow.

Post authorization responses

ResponseDescription
200 SuccessSuccessful reponse.
401 Invalid Access TokenApplication token is incorrect. Ensure your are using the Server token, available on your application's detail and settings pages.
401 Invalid token context. Please use a HTTP token for this requestApplication token is incorrect. Ensure your are using the Server token, available on your application's detail and settings pages.
401 Request Origin does not match token DomainThe request is not coming from the domain specified in your application's settings page.

Code exchange

If you have initialized with response_type=code and the user accepts your request, Bridge API responds to your callback with a temporary validation code as well as the state specified in the initialization step (if provided). If the states don't match, the request has been created by a third party and the process should be aborted.

Exchange the validation code immediately for an access token. The validation code expires within a few minutes. Ensure the code exchange is done using a POST request to avoid exposing your client_secret.

Parameters for code exchange request

Required parameters
ParameterTypeDescription
client_idstringYour application's unique identifier, and can be found on your application's details and settings pages.
client_secretstringYour application's secret token, and can be found on your application's details and settings pages.
redirect_uristringDesignates where the result (credential or error) is sent after the completion of the flow. This must match the Redirect URL specified in your application settings.
codestringThis is the validation code sent back by Bridge API
Optional parameters
ParameterTypeDescription
statestringA single-use string that you may implement, and will passed back at the end of the flow. The state parameter can help you secure against the possibility of cross-site request forgery.

Example code exchange

POST https://rets.io/oauth/tokenRequest Body
{
  "client_id": {client_id},
  "client_secret": {client_secret},
  "redirect_uri": {redirect_uri},
  "grant_type": "authorization_code",
  "code": {code},
  "state": {state}
}
Example response
{
  "access_token": {access_token},
  "expiry": {expiry},
  "token_type": {token_type}
}

Refresh token exchange

If you requested and received authorization for an offline scope from the user, the code exchage above will return a refresh_token in addition to the access_token. This refresh token can be used to generate a new access token once the original one expires.

Ensure the code exchange is done using a POST request to avoid exposing your client_secret.

Parameters for refresh token exchange request

Required parameters
ParameterTypeDescription
client_idstringYour application's unique identifier, and can be found on your application's details and settings pages.
client_secretstringYour application's secret token, and can be found on your application's details and settings pages.
redirect_uristringDesignates where the result (credential or error) is sent after the completion of the flow. This must match the Redirect URL specified in your application settings.
refresh_tokenstringThis is the refresh token sent back by Bridge API
Optional parameters
ParameterTypeDescription
statestringA single-use string that you may implement, and will passed back at the end of the flow. The state parameter can help you secure against the possibility of cross-site request forgery.

Example code exchange

POST https://rets.io/oauth/tokenRequest Body
{
  "client_id": {client_id},
  "client_secret": {client_secret},
  "redirect_uri": {redirect_uri},
  "grant_type": "refresh_token",
  "refresh_token": {refresh_token},
  "state": {state}
}
Example response
{
  "access_token": {access_token},
  "token_type": {token_type}
}

Push

Bridge API's Push functionality allows you listen for changes in the datasets, and trigger events based on chosen criteria. This may include criteria such as price and status changes of a listing, or new listings becoming available on a specific dataset.

Currently only MLS listing data is supported for push notifications.

Using the Push API

The Push API will POST to the supplied URL with resources that satisfy the specified criteria. The API expects endpoints to return POST requests with a HTTP response code 200. Webhooks are tied to your application's Server token, and will only return results for datasets that have been approved for that application. The push event will trigger when any resource that match your query is added to the dataset, or changes to meet the specified criteria.

The following MLS dataset resources are available: listing, agent, and office.

Create a webhook

POST https://rets.io/api/v2/hooks/{applicationID}?access_token={server token}Request body
{
  "resource": {resource},
  "query": {query},
  "url": {your server url},
  "datasetID": {dataset.id here (not datasetCode)}
}
Response
{
  "success": true,
  "status": 201,
  "bundle": {
    "id": {id},
    "resource": {resource},
    "url": {your server url},
    "query": {query},
    "status": {webhook status},
    "datasetID": {datasetID},
    "applicationID": {applicationID}
  }
}

Get a webhook

GET https://rets.io/api/v2/hooks/{applicationID}/{hookID}?access_token={server token}Response
{
  "success": true,
  "status": 200,
  "bundle": {
    "id": {id},
    "resource": {listings},
    "url": {your server url},
    "query": {query},
    "application": {app},
    "applicationID": "applicationID",
    "datasetID": {datasetID},
    "status": {webhook status}
  }
}

Test a webhook

GET https://rets.io/api/v2/hooks/{applicationID}/{hookID}/test?access_token={server token}Response
{
  "success": true,
  "status": 200,
  "bundle": { }
}

Edit a webhook

PATCH https://rets.io/api/v2/hooks/{applicationID}/{hookID}?access_token={server token}Request body
{
  "query": {query}
}
Response
{
  "success": true,
  "status": 200,
  "bundle": {
    "id": {id},
    "resource": {listings},
    "url": {your server url},
    "query": {query},
    "applicationID": "applicationID",
    "datasetID": {datasetID},
    "status": {webhook status}
  }
}

Delete a webhook

DEL https://rets.io/api/v2/{datasetID}/hooks/{hook ID}?access_token={server token}Response
{
  "success": true,
  "status": 200,
  "bundle": {
    "id": {id},
    "resource": {listings},
    "url": {your server url},
    "query": {query},
    "applicationID": "applicationID",
    "datasetID": {datasetID},
    "status": {webhook status}
  }
}

Get a list of webhooks for application

GET https://rets.io/api/v2/hooks/{applicationID}?access_token={server token}Response
{
  "success": true,
  "status": 200,
  "bundle": [
    {
      "id": {id},
      "resource": {resource},
      "url": {your server url},
      "query": {query},
      "datasetID": {datasetID},
      "applicationID": {applicationID},
      "status": {webhook status},
      "dataset": {
        "datasetCode": {datasetCode}
       }
    }
  ],
  "total": {number of hooks returned}
}