Table of Contents
Summary Report | Data Elements View | Performance View
Data Dictionary Report
Web API Report
Notifications | Sending Notifications | Notification Tracking
Archiving Endorsements | Auto-Archiving
My Account | Creating a Token
The RESO Certification process requires a provider (MLS vendor) to review customer (MLS) test results and then notify the customer through the RESO Certification System. The customer will then review the results and approve them to receive certification for the given endorsement.
At this time, there are two possible endorsements that can be issued to data providers, Data Dictionary 1.7 and Web API Core 2.0.0, each of which have different reports.
See more information about viewing Endorsements.
Summary reports show information about the resources, fields and lookups that were found on your server for the organization being viewed.
Each report contains two views, Data Elements and Performance, accessed from a dropdown at the top of the page.
Data Elements View
The Data Elements view shows the field and lookup counts and how they compare to industry averages. The counts are broken down by Advertised and Available data.
Advertised: the data elements that were found in the server metadata
Available: the data elements that were found in the payload during sampling
Use the Availability Threshold slider to set a minimum data availability that each field and lookup in the data set must be greater than or equal to. The default availability threshold level shows the count of data elements with availability greater than zero.
Located below the charts, the Resources dropdown menu provides a data filter to the specific resource selected. For example, if Property is selected, chart data will only include Property fields and lookups. Elements relating to other resources (e.g., Member, Office, etc.) will be omitted.
The Performance view shows your server performance metrics.
Note: You may opt out of displaying your server metrics publicly when sending the notification to the customer. If opted out, the performance metrics will be visible only to the customer and RESO admin staff.
Performance is measured on:
- Payload Size - how much data was retrieved when sampling the selected resource. “All” represents the average across all resources found, measured in megabytes (MB).
- Response Time - how long, on average, a request to the given server took to complete, measured in seconds (s).
- Throughput - the payload size divided by response time. Similar to an Internet speed test, this metric shows how quickly consumers might expect to retrieve data from the given server. Measured in megabytes per second (MB/s).
N/A - means that the given recipient has not completed Data Dictionary availability testing yet. Please contact RESO at email@example.com if you have any questions.
Estimated Seconds per 1,000 Records - the estimated time it takes to retrieve 1,000 records from the server. Shows for the specific provider and industry average.
Providers may reach out to firstname.lastname@example.org if they have further questions.
Data Dictionary Report
The Data Dictionary Report allows you to explore the data elements of the server submitted for RESO certification. See more information about Exploring the Data Dictionary Report.
Web API Report
IMPORTANT: All MLS providers are required to obtain the Web API Core endorsement prior to that of the Data Dictionary.
Once the endorsement has been obtained, select View Details at the right of the Web API Core 2.0.0 endorsement to view the report.
The Web API Core report displays the name of the organization that was tested as well as that of the data provider. If any of this information is incorrect, please contact RESO at email@example.com.
The report shows which version of OData the RESO Web API server was using and the authentication type, with the current options being OAuth 2 Bearer Token or Client Credentials. The fields that were used for testing and the status button are also shown.
Data providers (e.g., MLSs) can be notified of the availability of their Web API Report for certification approval by selecting the Passed button at the top right of this page. See more information about sending Notifications.
Certification testing results must be reviewed and approved by customers before the endorsements are certified. The review requests are sent via email.
Selecting Passed and then Notify Recipient for either the Data Dictionary or the Web API Core results will send a bundled review notification for both. The recipient will then be able to review and approve both results from a single link that directs them to the Certification Summary page.
Note: The bundled notification is only available when both Data Dictionary and Web API are in Passed status. Otherwise, the email will only include the single result that was selected for notification.
IMPORTANT: The email that includes a link to the results(s) should only be sent to the organization you are certifying. Any recipient of the email would have the ability to approve the results.
Select the Passed button from the endorsements page or any report page, then select Notify Recipient.
Select whether to Accept or Opt-Out of having the performance metrics displayed publicly and select Next.
The email entry screen displays which results will be included in the email. Enter the email address for your customer and select Send Now.
An email with a link to the results will be sent to your customer for review and approval. The button will then change from Passed to Notified.
Once the customer has approved the results, the button will change to Certified.
Providers are allowed to send a maximum of two notifications for each recipient.
If a notification has previously been sent, the notification count and recipient email address will appear when the Notified button is selected.
Providers may cancel the certification process when the endorsements are in the Passed or Notified status.
Select the Passed or Notified button and select Cancel Certification.
A confirmation of the cancelation is sent to the provider. The recipient is not notified of a cancel action.
The endorsement will now show as Canceled and may be archived (see below).
Providers may now archive endorsements and should do so for any organizations that they are no longer serving or contain results that are otherwise unwanted.
Archiving is available for endorsements in Passed, Notified, Certified, Canceled or Withdrawn status.
Select the status button on the endorsement you would like to archive and select Archive.
A notification of the archive action will be sent to the provider. The customer is not notified.
Certification endorsements are automatically archived and replaced if a new endorsement of the same type is initiated by the provider.
Auto-archiving will occur for endorsements in Passed, Notified, Canceled or Withdrawn status.
Endorsements in a permanent status (Certified, Revoked) will remain alongside the new endorsements. The old endorsements may be manually archived by the provider at any time.
Selecting My Account at the top of the page displays your user information and the ability to copy or create a new token hash. If any of this information is incorrect, please contact RESO at firstname.lastname@example.org.
Creating a Token
A token is needed in order to access the certification data via Web API.
Log in to certification.reso.org with your username and password.
Select My Account from the top toolbar.
Select the Create Token button.
The token will then be displayed along with options to copy it to the clipboard or to delete it (in the case of multiple tokens).
You may contact email@example.com for assistance.