Merging the many rets4r projects out there
Pull request Compare This branch is 213 commits behind josephholsten:master.
Latest commit 1155350 Mar 3, 2010 @josephholsten josephholsten Require mocha before shoulda to fix 'uninitialized constant Test::Uni…

	* test/test_helper.rb: require mocha earlier
Failed to load latest commit information.
test Require mocha before shoulda to fix 'uninitialized constant Test::Uni… Mar 3, 2010
.document Fix rdoc reference (Joseph Holsten) Nov 25, 2009
LICENSE Merge with bgetting Nov 16, 2009
README.rdoc fix links list Nov 26, 2009
RUBYS fixup tabs and newlines Nov 15, 2009
Rakefile Run tests that end in _test.rb Jan 22, 2010
TODO Added some docs, todos Nov 16, 2009
VERSION.yml Version bump to 1.1.16 Feb 6, 2010



RETS4R provides a native Ruby interface to the RETS (Real Estate Transaction Standard). It currently is built for the 1.5 specification, but support for 1.7 and 2.0 are planned. It does not currently implement all of the specification, but the most commonly used portions. Specifically, there is no support for Update transactions.

While this is the only “native” Ruby RETS library currently available (to my knowledge), there is another client written in C++ with Ruby bindings available from the Center for Realtor¨ Technology (



  • Ruby 1.8.4


Please see the LICENSE file.


This project was made possible in part by the Contra Costa Association of Realtors¨ (

Getting Started

Take a look at the examples directory. You'll find it more helpful than the unit tests because the unit tests work off of local files and mock objects, rather than making real transaction calls.

Due to the nature of this library, it is HIGHLY recommended that you have at least a basic understanding of the RETS protocol. The official RETS website is

Most of the time, you will be either searching for resources or getting objects, so begin there.