Select Page

Unique Organization Identifier (UOI)

RESO UOIRESO’s Unique Organization Identifier (UOI) provides a singular 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 helps with clear notation of data originators and allows for easier data deduplication. Technology partners can also use a UOI to look up association-to-MLS relationships, which 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. Last updated: 3/11/2023.

Parameter Description

 

ouid Search by Unique Organization ID (currently OUID; soon to be UOI).
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=Local Association
Example 2: https://www.reso.org/ouid/?type=State or Provincial Association
Example 3: https://www.reso.org/ouid/?type=MLS

 

Other types include Brokerage, Commercial, Pooled Platform and Technology Company.

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>LocalAssociation</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":"LocalAssociation",
	"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