simplyrets 1.0.7 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 412b35e38999019546945d6529debef414e4844f
-  data.tar.gz: ad7e6a70f4633e31c0daa4e67dd800030308fb6e
+  metadata.gz: fd6ac1b309459141e337958620bea863fb7bee7a
+  data.tar.gz: 94eb10e7dcc77dfc5028fa7dbbfd38f2423485c6
 SHA512:
-  metadata.gz: 8695c34518124f980b505d15034ad99e2ff34ec227e8e041da470e857d7f06d5f6d402f3dcc267db43d1a33534d2a26c2f79d793671514f3ec4cedd7481eec52
-  data.tar.gz: be04eb5215c2b210934bad81bbba88473ed7b5f4ba4d461cd1582543ecbd9958e2ba8cd412034a245a7ec8f97d0821bbddf71fd82228bbda67d64870e4a00120
+  metadata.gz: fb6ff3e6b1116074b14c484f789b60c93bafb05a14dd243a724fe99135ba84e6c5c370cb3eaea26542f797bf7d809efa066eb82b0faca98da29060dfc0b43190
+  data.tar.gz: 68b9672f0ff6eacdd04daa61ed8ce304431888c0e6e833c1ba548f188396263ea92e2b17faa59f7615c3157a1ef858f3c522f47e1891ea7829b77364b8daf2e4

data/Gemfile.lock

@@ -1,50 +1,52 @@
 PATH
   remote: .
   specs:
-    simplyrets (1.0.7)
-      json (~> 1.4, >= 1.4.6)
-      typhoeus (~> 0.2, >= 0.2.1)
+    simplyrets (2.0.0)
+      json (~> 1.8, >= 1.8.3)
+      typhoeus (~> 0.8, >= 0.8)
 
 GEM
   remote: http://rubygems.org/
   specs:
     ZenTest (4.11.0)
-    addressable (2.3.8)
+    addressable (2.4.0)
     autotest (4.4.6)
       ZenTest (>= 4.4.1)
-    autotest-fsevent (0.2.10)
+    autotest-fsevent (0.2.11)
       sys-uname
     autotest-growl (0.2.16)
     autotest-rails-pure (4.1.2)
-    crack (0.4.2)
+    crack (0.4.3)
       safe_yaml (~> 1.0.0)
     diff-lcs (1.2.5)
-    ethon (0.7.4)
+    ethon (0.9.0)
       ffi (>= 1.3.0)
     ffi (1.9.10)
+    hashdiff (0.3.0)
     json (1.8.3)
-    rspec (3.3.0)
-      rspec-core (~> 3.3.0)
-      rspec-expectations (~> 3.3.0)
-      rspec-mocks (~> 3.3.0)
-    rspec-core (3.3.2)
-      rspec-support (~> 3.3.0)
-    rspec-expectations (3.3.1)
+    rspec (3.4.0)
+      rspec-core (~> 3.4.0)
+      rspec-expectations (~> 3.4.0)
+      rspec-mocks (~> 3.4.0)
+    rspec-core (3.4.4)
+      rspec-support (~> 3.4.0)
+    rspec-expectations (3.4.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.3.0)
-    rspec-mocks (3.3.2)
+      rspec-support (~> 3.4.0)
+    rspec-mocks (3.4.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.3.0)
-    rspec-support (3.3.0)
+      rspec-support (~> 3.4.0)
+    rspec-support (3.4.1)
     safe_yaml (1.0.4)
     sys-uname (1.0.2)
       ffi (>= 1.0.0)
-    typhoeus (0.7.3)
-      ethon (>= 0.7.4)
+    typhoeus (0.8.0)
+      ethon (>= 0.8.0)
     vcr (2.9.3)
-    webmock (1.21.0)
+    webmock (1.24.6)
       addressable (>= 2.3.6)
       crack (>= 0.3.2)
+      hashdiff
 
 PLATFORMS
   ruby

data/Makefile

@@ -0,0 +1,48 @@
+
+FILES=$(shell git ls-files lib/ spec/ example.rb simplyrets.gemspec)
+
+generate: ruby-client.zip
+	rm -rf ruby-client/
+	unzip ruby-client.zip
+	cp -r ruby-client/lib/swagger_client.rb lib/simplyrets.rb
+	cp -r ruby-client/lib/swagger_client/* lib/simplyrets/
+
+	sed -i 's/SwaggerClient/SimplyRetsClient/g' $(FILES)
+	sed -i 's/swagger_client/simplyrets/g' $(FILES)
+	sed -i 's/VERSION = "1.0.0"/VERSION = "2.0.0"/g' $(FILES)
+	sed -i 's/simplyrets (1.0.0)/simplyrets (2.0.0)/g' $(FILES)
+
+	git grep -I --name-only -z -e '' | \
+		xargs -0 sed -i -e 's/[ \t]\+\(\r\?\)$$/\1/'
+
+	patch -p1 < multi-query-param.patch
+
+ruby-client.zip:
+	curl -XPOST http://generator.swagger.io/api/gen/clients/ruby			\
+		--verbose -D - --fail --show-error --insecure -s			\
+		-H 'Origin: http://editor.swagger.io'					\
+		-H 'Referer: http://editor.swagger.io'					\
+		-H 'Accept: application/json'						\
+		-H 'Content-Type: application/json'					\
+		-d '{"swaggerUrl": "https://docs.simplyrets.com/api/resources.json"}'	\
+		-o ruby-client.meta
+
+	cat ruby-client.meta | \
+		jq --raw-output .link | \
+		xargs curl  --output ruby-client.zip
+
+example:
+	bundle exec ./example.rb
+
+test:
+	bundle exec rspec
+
+release:
+	rm -f simplyrets-2.0.0.gem
+	gem build simplyrets.gemspec
+	#gem push simplyrets-2.0.0.gem
+
+clean:
+	rm -f ruby-client.zip
+	rm -f ruby-client.meta
+	rm -rf ruby-client

data/README.org

@@ -30,73 +30,20 @@ You can view the full API Documentation [[https://docs.simplyrets.com/api/index.
      %w(rubygems simplyrets).each {|models| require models}
 
      require "simplyrets"
-     require "properties_api"
-     require "listing"
 
-     SimplyRetsClient::SimplyRets.configure do |config|
+     SimplyRetsClient.configure do |config|
        config.username = 'simplyrets'
        config.password = 'simplyrets'
      end
 
      # all properties
-     ps = Properties_api.properties()
-     p ps
+     listings =  SimplyRetsClient::DefaultApi.new.properties_get()
+     p listings
    #+END_SRC
 
 
-** Setup the client
-
-   To start using the SDK, require =simplyrets= in your gemspec and
-   configure a client by setting your API key and API secret (we have
-   demo credentials available you can use for free!). Here's a short
-   example:
-
-   #+BEGIN_SRC ruby
-     require 'simplyrets'
-
-     SimplyRetsClient::SimplyRets.configure do |config|
-       config.username = 'simplyrets'
-       config.password = 'simplyrets'
-     end
-   #+END_SRC
-
-
-** Examples: Making Requests
-
-   Once you have instantiated the API Client, you can use the
-   Properties API to make requests for multiple or single listings.
-
-   Request all listings with no filters:
-   #+BEGIN_SRC ruby
-     require 'properties_api'
-
-     ps = SimplyRetsClient::Properties_api.properties()
-     p ps
-   #+END_SRC
-
-   Request a single listing by id:
-   #+BEGIN_SRC ruby
-     l = SimplyRetsClient::Properties_api.property(mls_id=19548526)
-     p l.mls
-   #+END_SRC
-
-
-   Multiple query parameters can be sent to the API to request more
-   refined results:
-   #+BEGIN_SRC ruby
-     # listings with minprice of $700,000 and minbeds of 4
-     ps = SimplyRetsClient::Properties_api.properties({:minprice => 700000, :minbeds => 4})
-     p ps
-   #+END_SRC
-
-   Sending back points to get listings in a geographical area:
-   #+BEGIN_SRC ruby
-     # listings within geographics points
-     points = ["29.723837146389066,-95.69778442382812" ,"29.938275329718987,-95.778442382812" ,"29.938275329718987,-95.32974243164061","29.723837146389066,-95.32974243164061"]
-     ps = SimplyRetsClient::Properties_api.properties({:points => points})
-     p ps
-   #+END_SRC
-
+    See the =examples.rb= file for more examples on how to call the
+    api with query parameters.
 
 ** Additional Info
 

data/example.rb

@@ -3,26 +3,36 @@
 %w(rubygems simplyrets).each {|lib| require lib}
 %w(rubygems simplyrets).each {|models| require models}
 
-require "simplyrets"
+require 'simplyrets'
 
 p "SimplyRets Ruby SDK"
 
-SimplyRetsClient::SimplyRets.configure do |config|
+SimplyRetsClient.configure do |config|
   config.username = 'simplyrets'
   config.password = 'simplyrets'
+  #config.debugging = true
 end
 
+# specify a set of latitude/longitude coordinates
 points = [ "29.723837146389066,-95.69778442382812", "29.938275329718987,-95.69778442382812", "29.938275329718987,-95.32974243164061", "29.723837146389066,-95.32974243164061" ]
 
 # Properties
-listings = SimplyRetsClient::Properties_api.properties({:minbeds => 2, :points => points})
+
+# instantiate a new api client
+api = SimplyRetsClient::DefaultApi.new
+
+# call GET /properties
+listings = api.properties_get({:minbeds => 2, :limit => 50, :type => ["Residential", "Rental"]})
 listings.each do |l|
+  p l.property.type
   p l.property
   p l.property.bedrooms
   p l.office.brokerid
 end
 
 # Single Listing
-prop = SimplyRetsClient::Properties_api.property(1005221)
+
+# call GET /properties/{mlsId}
+prop = api.properties_mls_id_get(1005221)
 p prop
 p prop.geo.lat

data/lib/simplyrets.rb

@@ -1,34 +1,55 @@
-# SimplyRets common files
-require 'simplyrets/simplyrets'
-require 'simplyrets/simplyrets/configuration'
-require 'simplyrets/simplyrets/api_error'
-require 'simplyrets/simplyrets/request'
-require 'simplyrets/simplyrets/response'
-require 'simplyrets/simplyrets/version'
+=begin
+SimplyRETS API
+
+The SimplyRETS API is an exciting step towards making it easier for\ndevelopers and real estate agents to build something awesome with\nreal estate data!\n\nThe documentation below makes live requests to our API using the\ntrial data. To get set up with the API using live MLS data, you\nmust have RETS credentials from your MLS, which you can then use to\ncreate an app with SimplyRETS. For more information on that\nprocess, please see our [FAQ](https://simplyrets.com/faq), [Getting\nStarted](https://simplyrets.com/blog/getting-set-up.html) page, or\n[contact us](https://simplyrets.com/\\#home-contact).\n\nBelow you'll find the API endpoints, query parameters, response bodies,\nand other information about using the SimplyRETS API. You can run\nqueries by clicking the 'Try it Out' button at the bottom of each\nsection.\n\n### Authentication\nThe SimplyRETS API uses Basic Authentication. When you create an\napp, you'll get a set of API credentials to access your\nlistings. If you're trying out the test data, you can use\n`simplyrets:simplyrets` for connecting to the API.\n\n### Media Types\nThe SimplyRETS API uses the `Accept` header to allow clients to\ncontrol media types (content versions). We maintain backwards\ncompatibility with API clients by allowing them to specify a\ncontent version. We highly recommend setting and explicity media\ntype when your application reaches production. Both the structure\nand content of our API response bodies is subject to change so we\ncan add new features while respecting the stability of applications\nwhich have already been developed.\n\nTo always use the latest SimplyRETS content version, simply use\n`application/json` in your application `Accept` header.\n\nIf you want to pin your clients media type to a specific version,\nyou can use the vendor-specific SimplyRETS media type, e.g.\n`application/vnd.simplyrets-v0.1+json\"`\n\nTo view all valid content-types for making an `OPTIONS`, make a\nrequest to the SimplyRETS api root\n\n`curl -XOPTIONS -u simplyrets:simplyrets https://api.simplyrets.com/`\n\nThe default media types used in our API responses may change in the\nfuture. If you're building an application and care about the\nstability of the API, be sure to request a specific media type in the\nAccept header as shown in the examples below.\n\nThe wordpress plugin automatically sets the `Accept` header for the\ncompatible SimplyRETS media types.\n\n### Pagination\nThere a few pieces of useful information about each request stored\nin the HTTP Headers:\n\n- `X-Total-Count` shows you the total amount of listings that match\n  your current query.\n- `Link` contains pre-built pagination links for accessing the next\n'page' of listings that match your query. Read more about that\n[here](https://simplyrets.com/blog/api-pagination.html).\n
+
+OpenAPI spec version: 1.0.0
+
+Generated by: https://github.com/swagger-api/swagger-codegen.git
+
+
+=end
+
+# Common files
+require 'simplyrets/api_client'
+require 'simplyrets/api_error'
+require 'simplyrets/version'
+require 'simplyrets/configuration'
 
 # Models
-require 'simplyrets/models/base_object'
-require 'simplyrets/models/street_address'
-require 'simplyrets/models/property'
+require 'simplyrets/models/agent'
+require 'simplyrets/models/broker'
+require 'simplyrets/models/contact_information'
+require 'simplyrets/models/error'
+require 'simplyrets/models/geographic_data'
 require 'simplyrets/models/listing'
-require 'simplyrets/models/open_house'
+require 'simplyrets/models/mls_information'
 require 'simplyrets/models/office'
-require 'simplyrets/models/agent'
+require 'simplyrets/models/open_house'
+require 'simplyrets/models/parking'
+require 'simplyrets/models/property'
 require 'simplyrets/models/sales'
 require 'simplyrets/models/school'
-require 'simplyrets/models/parking'
-require 'simplyrets/models/contact_information'
+require 'simplyrets/models/street_address'
 require 'simplyrets/models/tax'
-require 'simplyrets/models/geographic_data'
-require 'simplyrets/models/broker'
-require 'simplyrets/models/mls_information'
-require 'simplyrets/models/error'
 
 # APIs
 require 'simplyrets/api/default_api'
 
 module SimplyRetsClient
-  # Initialize the default configuration
-  SimplyRets.configuration = SimplyRets::Configuration.new
-  SimplyRets.configure { |config| }
+  class << self
+    # Customize default settings for the SDK using block.
+    #   SimplyRetsClient.configure do |config|
+    #     config.username = "xxx"
+    #     config.password = "xxx"
+    #   end
+    # If no block given, return the default Configuration object.
+    def configure
+      if block_given?
+        yield(Configuration.default)
+      else
+        Configuration.default
+      end
+    end
+  end
 end

data/lib/simplyrets/api/default_api.rb

@@ -1,85 +1,297 @@
+=begin
+SimplyRETS API
+
+The SimplyRETS API is an exciting step towards making it easier for\ndevelopers and real estate agents to build something awesome with\nreal estate data!\n\nThe documentation below makes live requests to our API using the\ntrial data. To get set up with the API using live MLS data, you\nmust have RETS credentials from your MLS, which you can then use to\ncreate an app with SimplyRETS. For more information on that\nprocess, please see our [FAQ](https://simplyrets.com/faq), [Getting\nStarted](https://simplyrets.com/blog/getting-set-up.html) page, or\n[contact us](https://simplyrets.com/\\#home-contact).\n\nBelow you'll find the API endpoints, query parameters, response bodies,\nand other information about using the SimplyRETS API. You can run\nqueries by clicking the 'Try it Out' button at the bottom of each\nsection.\n\n### Authentication\nThe SimplyRETS API uses Basic Authentication. When you create an\napp, you'll get a set of API credentials to access your\nlistings. If you're trying out the test data, you can use\n`simplyrets:simplyrets` for connecting to the API.\n\n### Media Types\nThe SimplyRETS API uses the `Accept` header to allow clients to\ncontrol media types (content versions). We maintain backwards\ncompatibility with API clients by allowing them to specify a\ncontent version. We highly recommend setting and explicity media\ntype when your application reaches production. Both the structure\nand content of our API response bodies is subject to change so we\ncan add new features while respecting the stability of applications\nwhich have already been developed.\n\nTo always use the latest SimplyRETS content version, simply use\n`application/json` in your application `Accept` header.\n\nIf you want to pin your clients media type to a specific version,\nyou can use the vendor-specific SimplyRETS media type, e.g.\n`application/vnd.simplyrets-v0.1+json\"`\n\nTo view all valid content-types for making an `OPTIONS`, make a\nrequest to the SimplyRETS api root\n\n`curl -XOPTIONS -u simplyrets:simplyrets https://api.simplyrets.com/`\n\nThe default media types used in our API responses may change in the\nfuture. If you're building an application and care about the\nstability of the API, be sure to request a specific media type in the\nAccept header as shown in the examples below.\n\nThe wordpress plugin automatically sets the `Accept` header for the\ncompatible SimplyRETS media types.\n\n### Pagination\nThere a few pieces of useful information about each request stored\nin the HTTP Headers:\n\n- `X-Total-Count` shows you the total amount of listings that match\n  your current query.\n- `Link` contains pre-built pagination links for accessing the next\n'page' of listings that match your query. Read more about that\n[here](https://simplyrets.com/blog/api-pagination.html).\n
+
+OpenAPI spec version: 1.0.0
+
+Generated by: https://github.com/swagger-api/swagger-codegen.git
+
+
+=end
+
 require "uri"
 
 module SimplyRetsClient
-  class Properties_api
+  class DefaultApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
 
-    # The SimplyRets Listings API
-    # This is the main endpoint for accessing your properties. View\nall of the available query parameters and make requests below!\nThe API uses Basic Authorization, which most HTTP libraries\nwill handle for you. To use the test test data (which is what\nthis pages uses), you can use the api key `simplyrets` and\nsecret `simplyrets`. Note that the test listings are not live\nMLS listings but the data, query parameters, and response\nbodies will all work the same.\n
+    # The SimplyRETS OpenHouses API
+    # This is the main endpoint for accessing openhouses.\n
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :q A fuzzy keyword search.\n
+    # @option opts [String] :type Request listings by a specific property type. This\ndefaults to Residential, and you can only specify one type\nin a single query.\n
+    # @option opts [String] :listing_id Request openhouses for a specific `listingId`.\n
+    # @option opts [Array<String>] :cities Filter the openhouses returned by a list of valid cities. A\nlist of valid cities can be found by making an OPTIONS\nrequest to the `/openhouses` endpoint.\n
+    # @option opts [Array<String>] :brokers Filter the listings returned by brokerage with a Broker ID.\nYou can specific multiple broker parameters. Note, the Broker\nID is provided by your MLS.\n
+    # @option opts [String] :agent Filter the listings returned by an agent ID.  Note, the\nAgent ID is provided by your MLS.\n
     # @option opts [Integer] :minprice Filter listings by a minimum price.\n
-    # @option opts [Integer] :maxprice Filter listings by a maximum price\n
+    # @option opts [DateTime] :startdate Scheduled date and time of the open house showing
+    # @option opts [Integer] :offset Used as a cursor for pagination. Increase the offset parameter\nby the limit to go to the next \&quot;page\&quot; of listings. Also take\na look at the Link HTTP Header for pre-built pagination.\n
+    # @option opts [Integer] :limit Set the number of listings to return in the response.\nThis defaults to 20 listings, and can be a maximum of 50.\nTo paginate through to the next page of listings, take a\nlook at the `offset` parameter, or the Link in the HTTP\nHeader.\n
+    # @option opts [String] :sort Sort the response by a specific field. Values starting\nwith a minus (-) denote descending order, while the others\nare ascending.\n
+    # @return [Array<OpenHouse>]
+    def openhouses_get(opts = {})
+      data, status_code, headers = openhouses_get_with_http_info(opts)
+      return data
+    end
+
+    # The SimplyRETS OpenHouses API
+    # This is the main endpoint for accessing openhouses.\n
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :type Request listings by a specific property type. This\ndefaults to Residential, and you can only specify one type\nin a single query.\n
+    # @option opts [String] :listing_id Request openhouses for a specific `listingId`.\n
+    # @option opts [Array<String>] :cities Filter the openhouses returned by a list of valid cities. A\nlist of valid cities can be found by making an OPTIONS\nrequest to the `/openhouses` endpoint.\n
+    # @option opts [Array<String>] :brokers Filter the listings returned by brokerage with a Broker ID.\nYou can specific multiple broker parameters. Note, the Broker\nID is provided by your MLS.\n
+    # @option opts [String] :agent Filter the listings returned by an agent ID.  Note, the\nAgent ID is provided by your MLS.\n
+    # @option opts [Integer] :minprice Filter listings by a minimum price.\n
+    # @option opts [DateTime] :startdate Scheduled date and time of the open house showing
+    # @option opts [Integer] :offset Used as a cursor for pagination. Increase the offset parameter\nby the limit to go to the next \&quot;page\&quot; of listings. Also take\na look at the Link HTTP Header for pre-built pagination.\n
+    # @option opts [Integer] :limit Set the number of listings to return in the response.\nThis defaults to 20 listings, and can be a maximum of 50.\nTo paginate through to the next page of listings, take a\nlook at the `offset` parameter, or the Link in the HTTP\nHeader.\n
+    # @option opts [String] :sort Sort the response by a specific field. Values starting\nwith a minus (-) denote descending order, while the others\nare ascending.\n
+    # @return [Array<(Array<OpenHouse>, Fixnum, Hash)>] Array<OpenHouse> data, response status code and response headers
+    def openhouses_get_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: DefaultApi#openhouses_get ..."
+      end
+
+      if opts[:'type'] && !['Residential', 'Rental', 'Multifamily', 'Condominium', 'Commercial', 'Land'].include?(opts[:'type'])
+        fail 'invalid value for "type", must be one of Residential, Rental, Multifamily, Condominium, Commercial, Land'
+      end
+
+      if opts[:'sort'] && !['listprice', '-listprice', 'listdate', '-listdate', 'beds', '-beds', 'baths', '-baths'].include?(opts[:'sort'])
+        fail 'invalid value for "sort", must be one of listprice, -listprice, listdate, -listdate, beds, -beds, baths, -baths'
+      end
+
+      # resource path
+      local_var_path = "/openhouses".sub('{format}','json')
+
+      # query parameters
+      query_params = {}
+      query_params[:'type'] = opts[:'type'] if opts[:'type']
+      query_params[:'listingId'] = opts[:'listing_id'] if opts[:'listing_id']
+      query_params[:'cities'] = @api_client.build_collection_param(opts[:'cities'], :multi) if opts[:'cities']
+      query_params[:'brokers'] = @api_client.build_collection_param(opts[:'brokers'], :multi) if opts[:'brokers']
+      query_params[:'agent'] = opts[:'agent'] if opts[:'agent']
+      query_params[:'minprice'] = opts[:'minprice'] if opts[:'minprice']
+      query_params[:'startdate'] = opts[:'startdate'] if opts[:'startdate']
+      query_params[:'offset'] = opts[:'offset'] if opts[:'offset']
+      query_params[:'limit'] = opts[:'limit'] if opts[:'limit']
+      query_params[:'sort'] = opts[:'sort'] if opts[:'sort']
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      _header_accept = ['application/json', 'application/vnd.simplyrets-v0.1+json']
+      _header_accept_result = @api_client.select_header_accept(_header_accept) and header_params['Accept'] = _header_accept_result
+
+      # HTTP header 'Content-Type'
+      _header_content_type = ['application/json']
+      header_params['Content-Type'] = @api_client.select_header_content_type(_header_content_type)
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+
+      auth_names = ['basicAuth']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'Array<OpenHouse>')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DefaultApi#openhouses_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Single OpenHouse Endpoint
+    # Use this endpoint for accessing a single OpenHouse.\n
+    # @param open_house_key A unique OpenHouse identification key
+    # @param [Hash] opts the optional parameters
+    # @return [OpenHouse]
+    def openhouses_open_house_key_get(open_house_key, opts = {})
+      data, status_code, headers = openhouses_open_house_key_get_with_http_info(open_house_key, opts)
+      return data
+    end
+
+    # Single OpenHouse Endpoint
+    # Use this endpoint for accessing a single OpenHouse.\n
+    # @param open_house_key A unique OpenHouse identification key
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(OpenHouse, Fixnum, Hash)>] OpenHouse data, response status code and response headers
+    def openhouses_open_house_key_get_with_http_info(open_house_key, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: DefaultApi#openhouses_open_house_key_get ..."
+      end
+
+      # verify the required parameter 'open_house_key' is set
+      fail "Missing the required parameter 'open_house_key' when calling openhouses_open_house_key_get" if open_house_key.nil?
+
+      # resource path
+      local_var_path = "/openhouses/{openHouseKey}".sub('{format}','json').sub('{' + 'openHouseKey' + '}', open_house_key.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      _header_accept = ['application/json', 'application/vnd.simplyrets-v0.1+json']
+      _header_accept_result = @api_client.select_header_accept(_header_accept) and header_params['Accept'] = _header_accept_result
+
+      # HTTP header 'Content-Type'
+      _header_content_type = ['application/json']
+      header_params['Content-Type'] = @api_client.select_header_content_type(_header_content_type)
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+
+      auth_names = ['basicAuth']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'OpenHouse')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DefaultApi#openhouses_open_house_key_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # The SimplyRETS Listings API
+    # This is the main endpoint for accessing your properties. View\nall of the available query parameters and make requests below!\nThe API uses Basic Authentication, which most HTTP libraries\nwill handle for you. To use the test data (which is what this\npages uses), you can use the api key `simplyrets` and secret\n`simplyrets`. Note that these test listings are not live MLS\nlistings but the data, query parameters, and response bodies\nwill all work the same.\n
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :q A textual keyword search. This parameter will search  the following\nfields, when available:\n  - listingId (This does _not_ search the `mlsId` field in the SimplyRETS response body)\n  - street number\n  - street name\n  - mls area (major)\n  - city\n  - subdivision name\n  - postal code\nNOTE\n
+    # @option opts [Array<String>] :status Request listings by a specific status. This parameter\ndefaults to active and you can specify multiple statuses\nin a single query.\n\nListing statuses depend on your MLS&#39;s availability. Below is\na brief description of each status with possible synonyms which\nmay map to your MLS-specific statuses\n- *Active*: Active Listing which is still on the market\n- *ActiveUnderContract*: An offer has been accepted but the listing is still on market. Synonyms: Accepting Backup Offers, Backup Offer, Active With Accepted. Synonyms: Offer, Backup, Contingent\n- *Pending*: An offer has been accepted and the listing is no longer on market. Synonyms: Offer Accepted, Under Contract\n- *Hold*: The listing has been withdrawn from the market, but a contract\n  still exists between the seller and the listing member. Synonyms: Hold, Hold Do Not Show, Temp Off Market\n- *Withdrawn*: The listing has been withdrawn from the market, but a contract\n  still exists between the seller and the listing member. Synonyms: Hold, Hold Do Not Show, Temp Off Market\n- *Closed*: The purchase agreement has been fulfilled or the lease\n  agreement has been executed. Synonyms: Sold, Leased, Rented, Closed Sale\n- *Expired*: The listing contract has expired\n- *Delete*: The listing contract was never valid or other reason for the contract to be nullified. Synonyms: Kill, Zap\n- *Incomplete*: The listing has not yet be completely entered and is not yet\n  published in the MLS. Synonyms: Draft, Partially Complted\n- *ComingSoon*\n
+    # @option opts [Array<String>] :type Request listings by a specific property type. This\ndefaults to Residential and Rental. You can specify\nmultiple property types in a single query.\n
     # @option opts [String] :agent Filter the listings returned by an agent ID.  Note, the\nAgent ID is provided by your MLS.\n
+    # @option opts [Array<String>] :brokers Filter the listings returned by brokerage with a Broker\nID. For some MLS areas, this is the ListOfficeId (Listing\nOffice ID).  You can specific multiple broker\nparameters. Note, this query parameter is only available\nif a Broker ID is provided by your MLS.\n
+    # @option opts [Integer] :minprice Filter listings by a minimum price.\n
+    # @option opts [Integer] :maxprice Filter listings by a maximum price\n
     # @option opts [Integer] :minarea Filter listings by a minimum area size in Sq Ft.\n
     # @option opts [Integer] :maxarea Filter listings by a maximum area size in Sq Ft.\n
     # @option opts [Integer] :minbaths Filter listings by a minimum number of bathrooms.\n
     # @option opts [Integer] :maxbaths Filter listings by a maximum number of bathrooms.\n
     # @option opts [Integer] :minbeds Filter listings by a minimum number of bedrooms.\n
     # @option opts [Integer] :maxbeds Filter listings by a maximum number of bedrooms.\n
+    # @option opts [Integer] :maxdom Filter listings by a maximum number of days on market.\n_Note that your MLS must provide Days on Market data._\n
+    # @option opts [Integer] :minyear Filter listings by a setting a minimum year built.\n
     # @option opts [Integer] :limit Set the number of listings to return in the response.\nThis defaults to 20 listings, and can be a maximum of 50.\nTo paginate through to the next page of listings, take a\nlook at the `offset` parameter, or the Link in the HTTP\nHeader.\n
-    # @option opts [Integer] :offset Used as a cursor for pagination. Increase the offset parameter\nby the limit to go to the next \&quot;page\&quot; of listings. Also take\na look at the Link HTTP Header for pre-built pagination.\n
-    # @option opts [Array<String>] :brokers Filter the listings returned by brokerage with a Broker ID.\nYou can specific multiple broker parameters. Note, the Broker\nID is provided by your MLS.\n
-    # @option opts [Array<String>] :features Filter the listings returned by specific features.  You\ncan specify multiple.\n
-    # @option opts [Array<String>] :amenities Filter the listings returned by specific amenities.  You\ncan specify multiple amenities.\n
+    # @option opts [Integer] :offset Used as a cursor for pagination. Increase the offset\nparameter by the limit to go to the next \&quot;page\&quot; of\nlistings. Also take a look at the Link HTTP Header for\npre-built pagination.\n
+    # @option opts [String] :vendor Used to specify the vendor (MLS) to search from. This\nparameter is required on multi-MLS apps, and you can only\nquery one vendor at a time. To get your vendor id&#39;s make\nan OPTIONS request to https://api.simplyrets.com.\n
+    # @option opts [Array<String>] :postal_codes Filter the listings returned by postal codes / zip\ncode. You can specify multiple.\n
+    # @option opts [Array<String>] :features Filter the listings by specific interior features.  You\ncan filter by multiple. For example, to filter trial listings\nby multiple features you can use,\nReturn listings that are within a set of latitude\nlongitude coordinates. For example,\n\n```\nWet Bar\nHigh Ceiling\n```\n\ne.g. `https://simplyrets.com/services?features=Wet%20Bar&amp;features=High%20Ceiling`\n\nThe features provided by your MLS can be seen in your\nOPTIONS request. To view all valid features, make a\nrequest to the SimplyRETS api root\n\n`curl -XOPTIONS -u simplyrets:simplyrets https://api.simplyrets.com/`\n
+    # @option opts [String] :water Query water/waterfront listings only. Specify `true` to\nfilter waterfront listings.\n
     # @option opts [Array<String>] :neighborhoods Filter the listings returned by specific neighborhoods and\nsubdivisions. You can specify multiple.\n
-    # @option opts [Array<String>] :points A list of latitude longitude coordinates which contain\nthe property. Our documentation generator does not yet\nsupport using a list of parameters.\n
+    # @option opts [Array<String>] :cities Filter the listings returned by specific cities. You can\nspecify multiple.\n
     # @option opts [Array<String>] :counties Filter the listings returned by specific counties. You can\nspecify multiple.\n
-    # @option opts [Array<String>] :status Filter the listings returned by a specific status. You can\nspecify multiple.\n
-    # @option opts [String] :type Request listings by a specific property type. This\ndefaults to searching by Residential & Rental, and you can only specify multiple property types in a single query.\n
+    # @option opts [Array<String>] :points Return listings that are within a set of latitude\nlongitude coordinates. For example;\n```\n29.723837,-95.69778\n29.938275,-95.69778\n29.938275,-95.32974\n29.723837,-95.32974\n```\nNote that some MLS&#39;s do not provide latitude and longitude\nfor their listings, which is required for this parameter\nto work. In these cases, SimplyRETS offers a [Geocoding\nAddon](https://simplyrets.com/services#geocoding).\n\nCheck out our\n[blog post](https://simplyrets.com/blog/interactive-map-search.html)\non using the `points` parameter to build a map-based app\nin javascript.\n
+    # @option opts [Array<String>] :include Include a extra fields which are not in the default\nresponse body\n- &#39;association&#39; includes additional HOA data\n- &#39;agreement&#39; information on the listing agreement\n- &#39;garageSpaces&#39; additional garage data\n- &#39;maintenanceExpense&#39; data on maintenance expenses\n- &#39;parking&#39; additional parking data\n- &#39;pool&#39; includes an additional pool description\n- &#39;taxAnnualAmount&#39; include the annual tax amount\n- &#39;taxYear&#39; include the tax year data\n- &#39;rooms&#39; include parameter will include\n   any additional rooms as a list.\n\nNote that your MLS must provide these fields in their RETS\ndata for them to be available in the API response.\n
     # @option opts [String] :sort Sort the response by a specific field. Values starting\nwith a minus (-) denote descending order, while the others\nare ascending.\n
-    # @option opts [String] :include Include a limited set of extra fields which are not found\nin the default response body\n- &#39;rooms&#39; include parameter will include\n   any additional rooms as a list.\n- &#39;pool&#39; includes an additional pool description\n- &#39;association&#39; includes additional home owners association data\n
     # @return [Array<Listing>]
-    def self.properties(opts = {})
-      if SimplyRets.configuration.debug
-        SimplyRets.logger.debug "Calling API: DefaultApi#properties ..."
+    def properties_get(opts = {})
+      data, status_code, headers = properties_get_with_http_info(opts)
+      return data
+    end
+
+    # The SimplyRETS Listings API
+    # This is the main endpoint for accessing your properties. View\nall of the available query parameters and make requests below!\nThe API uses Basic Authentication, which most HTTP libraries\nwill handle for you. To use the test data (which is what this\npages uses), you can use the api key `simplyrets` and secret\n`simplyrets`. Note that these test listings are not live MLS\nlistings but the data, query parameters, and response bodies\nwill all work the same.\n
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :q A textual keyword search. This parameter will search  the following\nfields, when available:\n  - listingId (This does _not_ search the `mlsId` field in the SimplyRETS response body)\n  - street number\n  - street name\n  - mls area (major)\n  - city\n  - subdivision name\n  - postal code\nNOTE\n
+    # @option opts [Array<String>] :status Request listings by a specific status. This parameter\ndefaults to active and you can specify multiple statuses\nin a single query.\n\nListing statuses depend on your MLS&#39;s availability. Below is\na brief description of each status with possible synonyms which\nmay map to your MLS-specific statuses\n- *Active*: Active Listing which is still on the market\n- *ActiveUnderContract*: An offer has been accepted but the listing is still on market. Synonyms: Accepting Backup Offers, Backup Offer, Active With Accepted. Synonyms: Offer, Backup, Contingent\n- *Pending*: An offer has been accepted and the listing is no longer on market. Synonyms: Offer Accepted, Under Contract\n- *Hold*: The listing has been withdrawn from the market, but a contract\n  still exists between the seller and the listing member. Synonyms: Hold, Hold Do Not Show, Temp Off Market\n- *Withdrawn*: The listing has been withdrawn from the market, but a contract\n  still exists between the seller and the listing member. Synonyms: Hold, Hold Do Not Show, Temp Off Market\n- *Closed*: The purchase agreement has been fulfilled or the lease\n  agreement has been executed. Synonyms: Sold, Leased, Rented, Closed Sale\n- *Expired*: The listing contract has expired\n- *Delete*: The listing contract was never valid or other reason for the contract to be nullified. Synonyms: Kill, Zap\n- *Incomplete*: The listing has not yet be completely entered and is not yet\n  published in the MLS. Synonyms: Draft, Partially Complted\n- *ComingSoon*\n
+    # @option opts [Array<String>] :type Request listings by a specific property type. This\ndefaults to Residential and Rental. You can specify\nmultiple property types in a single query.\n
+    # @option opts [String] :agent Filter the listings returned by an agent ID.  Note, the\nAgent ID is provided by your MLS.\n
+    # @option opts [Array<String>] :brokers Filter the listings returned by brokerage with a Broker\nID. For some MLS areas, this is the ListOfficeId (Listing\nOffice ID).  You can specific multiple broker\nparameters. Note, this query parameter is only available\nif a Broker ID is provided by your MLS.\n
+    # @option opts [Integer] :minprice Filter listings by a minimum price.\n
+    # @option opts [Integer] :maxprice Filter listings by a maximum price\n
+    # @option opts [Integer] :minarea Filter listings by a minimum area size in Sq Ft.\n
+    # @option opts [Integer] :maxarea Filter listings by a maximum area size in Sq Ft.\n
+    # @option opts [Integer] :minbaths Filter listings by a minimum number of bathrooms.\n
+    # @option opts [Integer] :maxbaths Filter listings by a maximum number of bathrooms.\n
+    # @option opts [Integer] :minbeds Filter listings by a minimum number of bedrooms.\n
+    # @option opts [Integer] :maxbeds Filter listings by a maximum number of bedrooms.\n
+    # @option opts [Integer] :maxdom Filter listings by a maximum number of days on market.\n_Note that your MLS must provide Days on Market data._\n
+    # @option opts [Integer] :minyear Filter listings by a setting a minimum year built.\n
+    # @option opts [Integer] :limit Set the number of listings to return in the response.\nThis defaults to 20 listings, and can be a maximum of 50.\nTo paginate through to the next page of listings, take a\nlook at the `offset` parameter, or the Link in the HTTP\nHeader.\n
+    # @option opts [Integer] :offset Used as a cursor for pagination. Increase the offset\nparameter by the limit to go to the next \&quot;page\&quot; of\nlistings. Also take a look at the Link HTTP Header for\npre-built pagination.\n
+    # @option opts [String] :vendor Used to specify the vendor (MLS) to search from. This\nparameter is required on multi-MLS apps, and you can only\nquery one vendor at a time. To get your vendor id&#39;s make\nan OPTIONS request to https://api.simplyrets.com.\n
+    # @option opts [Array<String>] :postal_codes Filter the listings returned by postal codes / zip\ncode. You can specify multiple.\n
+    # @option opts [Array<String>] :features Filter the listings by specific interior features.  You\ncan filter by multiple. For example, to filter trial listings\nby multiple features you can use,\nReturn listings that are within a set of latitude\nlongitude coordinates. For example,\n\n```\nWet Bar\nHigh Ceiling\n```\n\ne.g. `https://simplyrets.com/services?features=Wet%20Bar&amp;features=High%20Ceiling`\n\nThe features provided by your MLS can be seen in your\nOPTIONS request. To view all valid features, make a\nrequest to the SimplyRETS api root\n\n`curl -XOPTIONS -u simplyrets:simplyrets https://api.simplyrets.com/`\n
+    # @option opts [String] :water Query water/waterfront listings only. Specify `true` to\nfilter waterfront listings.\n
+    # @option opts [Array<String>] :neighborhoods Filter the listings returned by specific neighborhoods and\nsubdivisions. You can specify multiple.\n
+    # @option opts [Array<String>] :cities Filter the listings returned by specific cities. You can\nspecify multiple.\n
+    # @option opts [Array<String>] :counties Filter the listings returned by specific counties. You can\nspecify multiple.\n
+    # @option opts [Array<String>] :points Return listings that are within a set of latitude\nlongitude coordinates. For example;\n```\n29.723837,-95.69778\n29.938275,-95.69778\n29.938275,-95.32974\n29.723837,-95.32974\n```\nNote that some MLS&#39;s do not provide latitude and longitude\nfor their listings, which is required for this parameter\nto work. In these cases, SimplyRETS offers a [Geocoding\nAddon](https://simplyrets.com/services#geocoding).\n\nCheck out our\n[blog post](https://simplyrets.com/blog/interactive-map-search.html)\non using the `points` parameter to build a map-based app\nin javascript.\n
+    # @option opts [Array<String>] :include Include a extra fields which are not in the default\nresponse body\n- &#39;association&#39; includes additional HOA data\n- &#39;agreement&#39; information on the listing agreement\n- &#39;garageSpaces&#39; additional garage data\n- &#39;maintenanceExpense&#39; data on maintenance expenses\n- &#39;parking&#39; additional parking data\n- &#39;pool&#39; includes an additional pool description\n- &#39;taxAnnualAmount&#39; include the annual tax amount\n- &#39;taxYear&#39; include the tax year data\n- &#39;rooms&#39; include parameter will include\n   any additional rooms as a list.\n\nNote that your MLS must provide these fields in their RETS\ndata for them to be available in the API response.\n
+    # @option opts [String] :sort Sort the response by a specific field. Values starting\nwith a minus (-) denote descending order, while the others\nare ascending.\n
+    # @return [Array<(Array<Listing>, Fixnum, Hash)>] Array<Listing> data, response status code and response headers
+    def properties_get_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: DefaultApi#properties_get ..."
       end
 
       if opts[:'sort'] && !['listprice', '-listprice', 'listdate', '-listdate', 'beds', '-beds', 'baths', '-baths'].include?(opts[:'sort'])
         fail 'invalid value for "sort", must be one of listprice, -listprice, listdate, -listdate, beds, -beds, baths, -baths'
       end
 
-      if opts[:'include'] && !['pool', 'rooms', 'association'].include?(opts[:'include'])
-        fail 'invalid value for "include", must be one of pool, rooms, association'
-      end
-
       # resource path
-      path = "/properties".sub('{format}','json')
+      local_var_path = "/properties".sub('{format}','json')
 
       # query parameters
       query_params = {}
       query_params[:'q'] = opts[:'q'] if opts[:'q']
+      query_params[:'status'] = @api_client.build_collection_param(opts[:'status'], :multi) if opts[:'status']
+      query_params[:'type'] = @api_client.build_collection_param(opts[:'type'], :multi) if opts[:'type']
+      query_params[:'agent'] = opts[:'agent'] if opts[:'agent']
+      query_params[:'brokers'] = @api_client.build_collection_param(opts[:'brokers'], :multi) if opts[:'brokers']
       query_params[:'minprice'] = opts[:'minprice'] if opts[:'minprice']
       query_params[:'maxprice'] = opts[:'maxprice'] if opts[:'maxprice']
-      query_params[:'agent'] = opts[:'agent'] if opts[:'agent']
       query_params[:'minarea'] = opts[:'minarea'] if opts[:'minarea']
       query_params[:'maxarea'] = opts[:'maxarea'] if opts[:'maxarea']
       query_params[:'minbaths'] = opts[:'minbaths'] if opts[:'minbaths']
       query_params[:'maxbaths'] = opts[:'maxbaths'] if opts[:'maxbaths']
       query_params[:'minbeds'] = opts[:'minbeds'] if opts[:'minbeds']
       query_params[:'maxbeds'] = opts[:'maxbeds'] if opts[:'maxbeds']
+      query_params[:'maxdom'] = opts[:'maxdom'] if opts[:'maxdom']
+      query_params[:'minyear'] = opts[:'minyear'] if opts[:'minyear']
       query_params[:'limit'] = opts[:'limit'] if opts[:'limit']
       query_params[:'offset'] = opts[:'offset'] if opts[:'offset']
-      query_params[:'brokers'] = opts[:'brokers'] if opts[:'brokers']
-      query_params[:'features'] = opts[:'features'] if opts[:'features']
-      query_params[:'amenities'] = opts[:'amenities'] if opts[:'amenities']
-      query_params[:'neighborhoods'] = opts[:'neighborhoods'] if opts[:'neighborhoods']
-      query_params[:'points'] = opts[:'points'] if opts[:'points']
-      query_params[:'counties'] = opts[:'counties'] if opts[:'counties']
-      query_params[:'status'] = opts[:'status'] if opts[:'status']
-      query_params[:'type'] = opts[:'type'] if opts[:'type']
+      query_params[:'vendor'] = opts[:'vendor'] if opts[:'vendor']
+      query_params[:'postalCodes'] = @api_client.build_collection_param(opts[:'postal_codes'], :multi) if opts[:'postal_codes']
+      query_params[:'features'] = @api_client.build_collection_param(opts[:'features'], :multi) if opts[:'features']
+      query_params[:'water'] = opts[:'water'] if opts[:'water']
+      query_params[:'neighborhoods'] = @api_client.build_collection_param(opts[:'neighborhoods'], :multi) if opts[:'neighborhoods']
+      query_params[:'cities'] = @api_client.build_collection_param(opts[:'cities'], :multi) if opts[:'cities']
+      query_params[:'counties'] = @api_client.build_collection_param(opts[:'counties'], :multi) if opts[:'counties']
+      query_params[:'points'] = @api_client.build_collection_param(opts[:'points'], :multi) if opts[:'points']
+      query_params[:'include'] = @api_client.build_collection_param(opts[:'include'], :multi) if opts[:'include']
       query_params[:'sort'] = opts[:'sort'] if opts[:'sort']
-      query_params[:'include'] = opts[:'include'] if opts[:'include']
 
       # header parameters
       header_params = {}
 
       # HTTP header 'Accept' (if needed)
-      _header_accept = []
-      _header_accept_result = SimplyRets::Request.select_header_accept(_header_accept) and header_params['Accept'] = _header_accept_result
+      _header_accept = ['application/json', 'application/vnd.simplyrets-v0.1+json']
+      _header_accept_result = @api_client.select_header_accept(_header_accept) and header_params['Accept'] = _header_accept_result
 
       # HTTP header 'Content-Type'
-      _header_content_type = []
-      header_params['Content-Type'] = SimplyRets::Request.select_header_content_type(_header_content_type)
+      _header_content_type = ['application/json']
+      header_params['Content-Type'] = @api_client.select_header_content_type(_header_content_type)
 
       # form parameters
       form_params = {}
@@ -87,45 +299,62 @@ module SimplyRetsClient
       # http body (model)
       post_body = nil
 
-
       auth_names = ['basicAuth']
-      response = SimplyRets::Request.new(:GET, path, {:params => query_params, :headers => header_params, :form_params => form_params, :body => post_body, :auth_names => auth_names}).make
-      result = response.deserialize('Array<Listing>')
-      if SimplyRets.configuration.debug
-        SimplyRets.logger.debug "API called: DefaultApi#properties. Result: #{result.inspect}"
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'Array<Listing>')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DefaultApi#properties_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
-      result
+      return data, status_code, headers
     end
 
     # Single Listing Endpoint
-    # Use this endpoint for accessing a single listing.\n
-    # @param listing_id A listings listingId (unique indentifier).
+    # Use this endpoint for accessing a single listing. When you\nmake a search to the `/properties` endpoint, each listing in\nthe response will contain a unique `mlsId` field which should\nbe used to request that listing on this route.\n\nThe `mlsId` field is a unique identifier for a listing which\nis specific to the SimplyRETS API only.  It is different from\nthe `listingId` field is the public number given to a listing\nby the MLS and is not used here.\n
+    # @param mls_id The `mlsId` field is a unique identifier which is specific\nto the SimplyRETS API only.  This field is different from\nthe `listingId` field (which is the public number given to\na listing by the MLS and is not used here).\n
     # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :include Include a extra fields which are not in the default\nresponse body\n- &#39;association&#39; includes additional HOA data\n- &#39;agreement&#39; information on the listing agreement\n- &#39;garageSpaces&#39; additional garage data\n- &#39;maintenanceExpense&#39; data on maintenance expenses\n- &#39;parking&#39; additional parking data\n- &#39;pool&#39; includes an additional pool description\n- &#39;rooms&#39; include parameter will include\n   any additional rooms as a list.\n\nNote that your MLS must provide these fields in their RETS\ndata for them to be available with valid data in the API\nresponse. If your MLS does not offer these fields, they will\ncontain &#39;null&#39;.\n
     # @return [Listing]
-    def self.property(listing_id, opts = {})
-      if SimplyRets.configuration.debug
-        SimplyRets.logger.debug "Calling API: DefaultApi#property ..."
+    def properties_mls_id_get(mls_id, opts = {})
+      data, status_code, headers = properties_mls_id_get_with_http_info(mls_id, opts)
+      return data
+    end
+
+    # Single Listing Endpoint
+    # Use this endpoint for accessing a single listing. When you\nmake a search to the `/properties` endpoint, each listing in\nthe response will contain a unique `mlsId` field which should\nbe used to request that listing on this route.\n\nThe `mlsId` field is a unique identifier for a listing which\nis specific to the SimplyRETS API only.  It is different from\nthe `listingId` field is the public number given to a listing\nby the MLS and is not used here.\n
+    # @param mls_id The `mlsId` field is a unique identifier which is specific\nto the SimplyRETS API only.  This field is different from\nthe `listingId` field (which is the public number given to\na listing by the MLS and is not used here).\n
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :include Include a extra fields which are not in the default\nresponse body\n- &#39;association&#39; includes additional HOA data\n- &#39;agreement&#39; information on the listing agreement\n- &#39;garageSpaces&#39; additional garage data\n- &#39;maintenanceExpense&#39; data on maintenance expenses\n- &#39;parking&#39; additional parking data\n- &#39;pool&#39; includes an additional pool description\n- &#39;rooms&#39; include parameter will include\n   any additional rooms as a list.\n\nNote that your MLS must provide these fields in their RETS\ndata for them to be available with valid data in the API\nresponse. If your MLS does not offer these fields, they will\ncontain &#39;null&#39;.\n
+    # @return [Array<(Listing, Fixnum, Hash)>] Listing data, response status code and response headers
+    def properties_mls_id_get_with_http_info(mls_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: DefaultApi#properties_mls_id_get ..."
       end
 
-      # verify the required parameter 'listing_id' is set
-      fail "Missing the required parameter 'listing_id' when calling property" if listing_id.nil?
+      # verify the required parameter 'mls_id' is set
+      fail "Missing the required parameter 'mls_id' when calling properties_mls_id_get" if mls_id.nil?
 
       # resource path
-      path = "/properties/{listingId}".sub('{format}','json').sub('{' + 'listingId' + '}', listing_id.to_s)
+      local_var_path = "/properties/{mlsId}".sub('{format}','json').sub('{' + 'mlsId' + '}', mls_id.to_s)
 
       # query parameters
       query_params = {}
+      query_params[:'include'] = @api_client.build_collection_param(opts[:'include'], :multi) if opts[:'include']
 
       # header parameters
       header_params = {}
 
       # HTTP header 'Accept' (if needed)
-      _header_accept = []
-      _header_accept_result = SimplyRets::Request.select_header_accept(_header_accept) and header_params['Accept'] = _header_accept_result
+      _header_accept = ['application/json', 'application/vnd.simplyrets-v0.1+json']
+      _header_accept_result = @api_client.select_header_accept(_header_accept) and header_params['Accept'] = _header_accept_result
 
       # HTTP header 'Content-Type'
-      _header_content_type = []
-      header_params['Content-Type'] = SimplyRets::Request.select_header_content_type(_header_content_type)
+      _header_content_type = ['application/json']
+      header_params['Content-Type'] = @api_client.select_header_content_type(_header_content_type)
 
       # form parameters
       form_params = {}
@@ -133,14 +362,18 @@ module SimplyRetsClient
       # http body (model)
       post_body = nil
 
-
       auth_names = ['basicAuth']
-      response = SimplyRets::Request.new(:GET, path, {:params => query_params, :headers => header_params, :form_params => form_params, :body => post_body, :auth_names => auth_names}).make
-      result = response.deserialize('Listing')
-      if SimplyRets.configuration.debug
-        SimplyRets.logger.debug "API called: DefaultApi#property. Result: #{result.inspect}"
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'Listing')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DefaultApi#properties_mls_id_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
-      result
+      return data, status_code, headers
     end
   end
 end