Organizational Unique Identifier (OUID) API

RESO’s Organization Unique Identifier (OUID) 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.

You can query the RESO OUID API to receive basic organizational information along with its OUID.

Data providers should include their OUID in data feeds so data recipients can accurately identify the organizational source (publisher) of each piece of data in an aggregated database.

Technology partners utilizing data should use the OUID 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 de-duplication. In addition, technology partners can utilize the OUID 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 OUID from version 1.5 and beyond .

This 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 OUID data. Data is updated every Friday.

Parameter Description

ouid Search by Organizational Unique ID.
Example: https://www.reso.org/ouid/?ouid=A00000007
assoc2mls Search by association to an MLS organization.
Example: https://www.reso.org/ouid/?assoc2mls=M00000001 https://www.reso.org/ouid/?assoc2mls=M00000002
active Search for active or inactive organizations.
Example:
Active: https://www.reso.org/ouid/?active=1
Inactive: https://www.reso.org/ouid/?active=0
org Search by an organization’s name or a portion of the name
Example: https://www.reso.org/ouid/?org=mlslistings
https://www.reso.org/ouid/?org=Macon County
type Search by organization type
Example: https://www.reso.org/ouid/?type=ASSOCIATION 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: https://www.reso.org/ouid/?country=USA 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 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
Example: https://www.reso.org/ouid/?start-date=2019-04-01
https://www.reso.org/ouid/?start-date=2019-04-01&end-date=2019-04-10
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
Example: https://www.reso.org/ouid/?end-date=2019-04-01
https://www.reso.org/ouid/?start-date=2019-04-01&end-date=2019-04-10
output To access the OUID 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 OUID 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"}

OUID API Update Request Form

Acknowledgements

Jeremy Crawford
Karen Dupriest

Allen Wright

Bill Kellog

Rick Sherwood

Clint Skutchan

DLU February 4th, 2020