Unique Organization Identifier (UOI)
RESO’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:
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
