Organizational Unique ID API

The official RESO Organization Unique Identifier (OUID) provides each individual organization within the Real Estate industry a unique ID alongside the comprehensive list of Realtor Associations, MLSs, system technology partners, technology partners and other affiliated businesses and data providers. The RESO OUID API provides the ability of any organization to query the API and provide back basic organization information and the most important aspect, the Organizational Unique ID. Data providers will include their own OUID in data feeds provided out to those receiving the data so the receivers of the data can accurately identify the organizational source (publisher) of each piece of data in an aggregated database will be included in RETS data feeds to clearly denote the publisher of the data.

There are many business cases for use of the OUID. For Multiple Listing Services and other data providers the purpose is to clearly tag data with the publisher (source) of the data which is distributed to licensed technology partners. For technology partners utilizing data, the OUID assists in managing multiple feeds and overlapping service areas with clear notation of data originator and provides the functionality of de-duplicating content in the data with a notation of the original source of the data allowing the correct data to be kept. In addition, technology partners can utilize the OUID to lookup the MLS(s) who would be a data provider for an Association. A good example is where an Association provides lockbox services and the correct MLS source and underlying data must be linked to the Association lockbox system; lockbox and showing systems often are Association provided services but require MLS data to serve the membership. The RESO Data Dictionary Version 1.5 and beyond will contain standardized containers for the Organizational Unique ID Store at the MLS and technology partner (data distributor).

This API can be used to extract active and inactive information about organizations. Parameters available of querying the dataset are as follows: ouid, active, org, type, city, state, country and zip. This is a public API, no credentials are required to query the Organizational Unique ID dataset. The dataset is updated regularly.

Parameter Description

ouid Search by Organizational Unique ID.
assoc2mls Search by association to an MLS organization.
active Search for active or inactive organizations.
org Search by an organization’s name or a portion of the name
Example: County
type Search by organization type
city Search by an organization’s city
state Search by the organization’s state.
country Search by the organization’s country.
zip Search by an organization’s zip or postal code
start-date Will return all records updated on and after the date requested until the “end-date” or current date if the end date is not set.
Format: YYYY-MM-DD
end-date Will return all records updated on and before the date requested until the “start-date” or all records prior if the start date is not set.
Format: YYYY-MM-DD
output To access the OUID data in JSON format. XML is the default output.
All parameters can be combined to allow for specific queries:

All listings are available by plainly requesting:

Note: If accessing the OUID database from a third party product the application expects the User Agent header with a valid value.

The XML Markup

  <name>Anchorage Board Of Realtors Inc</name>
   <address>3340 Arctic Blvd. #101</address>

The JSON Markup

	"name":"Anchorage Board Of Realtors Inc",
		 "address":"3340 Arctic Blvd. #101",
"copyright":"2019 RESO. All rights reserved"}

OUID API Update Request Form


Jeremy Crawford
Karen Dupriest

Allen Wright

Bill Kellog

Rick Sherwood

Clint Skutchan

DLU August 7th, 2019