919.459.6097 info@reso.org  

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.
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
All listings are available by plainly requesting: https://www.reso.org/ouid/

The XML Markup

<organizations>
 <organization>
  <name>Anchorage Board Of Realtors Inc</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>2017-05-22</updated>
 </organization>
</organizations>


 

OUID API Update Request Form