Freelancer API

Copyright (C) 2010 Trond Arve Nordheim - Binary Marbles


A Ruby gem for working with the new API. The goal of the project is to provide a clean way to integrate against the APIs and still keep the integration code looking clean and neat.

The library uses the JSON data provided by the APIs, and attempts to elegantly map the JSON data structures returned from the APIs into more “Ruby-feeling” objects by utilizing the json_mapper gem.


  • oAuth authentication.

  • Support for all APIs.

  • Sandbox support.

  • Ruby on Rails support (via separate project freelancer-rails - this project is still under heavy development).

Issues and missing features

  • Multipart fields are not implemented yet.

  • File associations on projects and messages are not implemented yet.




$ gem install freelancer

Note on Patches/Pull Requests

  • Fork the project.

  • Make your feature addition or bug fix.

  • Add tests for it. This is important so I don't break it in a future version unintentionally.

  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull).

  • Send me a pull request. Bonus points for topic branches.


Copyright © 2010 Trond Arve Nordheim. See LICENSE for details.