Blesta Blesta Build Status

A Ruby library for working with the Blesta Reseller API.

Blesta has been tested on MRI 1.8.7, MRI 1.9.2 and MRI 1.9.3.


gem install blesta
bundle install


require 'blesta'

Blesta.config do |c|
  c.base_uri '' # Root level URI for blesta API
  c.uid      'uid'                   # Blesta reseller UID
  c.password 'topsecret'             # Blesta reseller password


Get all licenses:

license =

Search for a specific license: "", :type => "domain" "1234567890AB", :type => "license"

Get the amount of credit in USD on the reseller account:

credit =

Get a list of all of the packages this reseller account may add:

packages =

Supported Methods

This gem implements the blesta reseller's API v1.0.

It includes:

  • Get Credit.
  • Get Licenses.
  • Get Packages.
  • Add License.
  • Cancel License.
  • Suspend License.
  • Unsuspend License.
  • Search Licenses.
  • Update Domain.


Blesta uses rspec for tests. To run:

bundle exec rake

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 (c) 2012 See LICENSE for details.