API docs by Redocly

RECO Registrant API (1.0.0)

Download OpenAPI specification:Download

URL: https://lab.rahb.ca/ License: MIT

An API for searching salespersons and brokerages registered with the Real Estate Council of Ontario (RECO). The official RECO registrant search can be found at their website: RECO Registrant Search.

For more information and source code, please visit the GitHub repository: RECO Registrant API.

Disclaimer: This specification and any associated projects are not affiliated with, endorsed by, or supported by the Real Estate Council of Ontario (RECO). This registrant search feature is intended for private, non-commercial use. Any commercial use of the information, in whole or in part, directly or indirectly, is specifically forbidden.

Salespersons

Search for salespersons registered with RECO by first name and last name.

Search salespersons

Search for salespersons registered with RECO. The search query must include a first name and last name with at least one character each. A middle name can also be provided.

Note: The search parameters must have at least one character each. If the search parameters are empty, the API will return a 422 error.

Authorizations:
bearerAuth
query Parameters
first_name
required
string

The first name of the salesperson. Minimum of one character.

middle_name
string

The middle name of the salesperson. Minimum of one character. (Optional)

last_name
required
string

The last name of the salesperson. Minimum of one character.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Brokerages

Search for brokerages registered with RECO by name, retrieve corporation information, and employees list.

Search brokerages

Search for brokerages registered with RECO. The search query must include a brokerage name with at least three characters. A city can also be provided.

Note: The brokerage_name parameter must have at least three characters. If the brokerage_name parameter is less than three characters, the API will return a 422 error.

Authorizations:
bearerAuth
query Parameters
brokerage_name
required
string

The name of the brokerage. Minimum of three characters.

city
string

The city of the brokerage. (Optional)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Corporation information

Retrieve information about a corporation registered with RECO. The corporation key can be found in the response of a brokerage search.

Note: A valid corporation_key must be provided. If a valid corporation_key is not provided, the API will return a 404 error.

Authorizations:
bearerAuth
path Parameters
corporation_key
required
string

The corporation key of the brokerage.

Responses

Response samples

Content type
application/json
{
  • "broker_of_record": "John Smith",
  • "brokerage_address": "123 Main St Unit: 100 CITYVILLE, ON A1A 1A1",
  • "brokerage_email": "[email protected]",
  • "brokerage_name": "Generic Realty Inc. Cityville",
  • "brokerage_phone": "555-555-5555",
  • "shareholders": [
    ]
}

Employees list

Retrieve a list of employees registered with RECO for a brokerage. The employees key can be found in the response of a brokerage search.

Note: A valid employees_key must be provided. If a valid employees_key is not provided, the API will return a 404 error.

Authorizations:
bearerAuth
path Parameters
employees_key
required
string

The employees key of the brokerage.

Responses

Response samples

Content type
application/json
[
  • {
    }
]