Select Page

Unique Organization Identifier (UOI)

RESO UOIRESO’s Unique Organization Identifier (UOI) provides a unique ID for a growing list of individual organizations within the real estate industry. The list includes local REALTOR® associations, state REALTOR® associations, commercial REALTOR® associations, MLSs, technology vendors, brokers and other affiliated businesses.

Data providers should include their UOI in data feeds so data recipients can accurately identify the organizational source (publisher) of each piece of data in an aggregated database. For a visual representation of real estate industry MLSs and their UOI information, you can view the RESO Certification map:

RESO MLS Map

Technology partners utilizing data should use the UOI to assist with the management of multiple data feeds and overlapping service areas. This will help with clear notation of data originators and will allow for easier data deduplication. In addition, technology partners can utilize the UOI to look up association-to-MLS relationships. This can be helpful when an association provides a lockbox or showing service, but the underlying data is from an MLS source that must be linked to the association’s system.

The RESO Data Dictionary includes standardized containers for the UOI (still documented as OUID at this time) from version 1.5 and beyond.

Unique Organization Identifier API

You can access the API for the RESO UOI (formerly OUID) to receive basic information about organizations along with their UOIs. The UOI API can be used to extract active and inactive information about organizations.

Parameters available for data query are as follows: ouid, active, org, type, city, state, country and zip. This is a public API. No credentials are required to query UOI data. Data is updated every Friday.

Parameter Description

ouid Search by Unique Organization ID (formerly OUID).
Example: https://www.reso.org/ouid/?ouid=A00000007
assoc2mls Search by association to an MLS organization.
Example 1: https://www.reso.org/ouid/?assoc2mls=M00000001
Example 2: https://www.reso.org/ouid/?assoc2mls=M00000002
active Search for active or inactive organizations.
Example of Active: https://www.reso.org/ouid/?active=1
Example of Inactive: https://www.reso.org/ouid/?active=0
org Search by an organization’s name or a portion of the name
Example 1: https://www.reso.org/ouid/?org=mlslistings
Example 2: https://www.reso.org/ouid/?org=Macon County
type Search by organization type
Example 1: https://www.reso.org/ouid/?type=Association
Example 2: https://www.reso.org/ouid/?type=MLS
city Search by an organization’s city
Example: https://www.reso.org/ouid/?city=Dallas
state Search by the organization’s state.
Example: https://www.reso.org/ouid/?state=AR
country Search by the organization’s country.
Example 1: https://www.reso.org/ouid/?country=USA
Example 2: https://www.reso.org/ouid/?country=Canada
zip Search by an organization’s ZIP or postal code
Example: https://www.reso.org/ouid/?zip=92111
start-date Returns all records updated on and after the date requested. Date format: YYYY-MM-DD.
Example: https://www.reso.org/ouid/?start-date=2020-04-01
end-date Returns all records updated on and before the date requested until the “start-date” or all records prior if the start date is not set. Date format: YYYY-MM-DD.
Example 1: https://www.reso.org/ouid/?start-date=2020-04-01&end-date=2020-05-31
Example 2: https://www.reso.org/ouid/?end-date=2020-04-01
output To access the UOI data in JSON format. XML is the default output.
Example: https://www.reso.org/ouid/?output=json
All parameters can be combined to allow for specific queries:
https://www.reso.org/ouid/?state=NC&type=MLS
https://www.reso.org/ouid/?state=CA&active=1

All listings are available by plainly requesting: https://www.reso.org/ouid/

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

The XML Markup

<organizations>
 <organization>
  <name>Anchorage Board Of REALTORS</name>
  <ouid>A00000002</ouid>
  <assoc2mls>M00000001</assoc2mls>
  <type>ASSOCIATION</type>
  <active>1</active>
  <url>www.ancboard.com</url>
  <location>
   <address>3340 Arctic Blvd, #101</address>
   <city>Anchorage</city>
   <state>AK</state>
   <zip>99503</zip>
   <country>USA</country>
  </location>
  <updated>2020-01-06</updated>
 </organization>
</organizations>

The JSON Markup

{"organization":
	{
	"name":"Anchorage Board Of REALTORS",
	"ouid":"A00000002",
	"assoc2mls":"M00000001",
	"type":"ASSOCIATION",
	"active":"1",
	"url":"www.ancboard.com",
	"location":
		{
		 "address":"3340 Arctic Blvd, #101",
		 "city":"Anchorage",
		 "state":"AK",
		 "zip":"99503",
		 "country":"USA"
		 },
	"updated":"2020-01-06"
	},
"copyright":"2020 RESO. All rights reserved"}

UOI API Update Request Form

Acknowledgements

Rick Sherwood

Allen Wright

Bill Kellogg

Clint Skutchan

DLU June 5th, 2020