A simple ABN search library for validating and obtaining ABN details from the Australian Business Register.
You will need a GUID to be able to use the ABR business lookup API. You can obtain one at the following link; abr.business.gov.au/Documentation/UserGuideWebRegistration.aspx
Rails Installation
Simply add the following line to your Gemfile and run bundle install.
gem 'abn_search'
Usage
require 'abn_search'
# Search by ABN Number
client = Abn::Search.new("YOUR_GUID_HERE")
result = client.search("59001215354")
=> {:acn=>"001215354", ":abn=>"59001215354", :entity_type=>"Australian Public Company", :status=>"Active", :main_name=>"SONY AUSTRALIA LIMITED", :trading_name=>"", :legal_name=>"", :other_trading_name=>"", :name=>"SONY AUSTRALIA LIMITED"}
puts result[:entity_type]
=> "Australian Public Company"
puts result[:status]
=> "Active"
puts result[:name]
=> "SONY AUSTRALIA LIMITED"
# Search by ACN Number
result = client.search_by_acn("001215354")
=> {:acn=>"001215354", ":abn=>"59001215354", :entity_type=>"Australian Public Company", :status=>"Active", :main_name=>"SONY AUSTRALIA LIMITED", :trading_name=>"", :legal_name=>"", :other_trading_name=>"", :name=>"SONY AUSTRALIA LIMITED"}
# Search by name
results = client.search_by_name("Sony", ['NSW'], '2000')
results.each do |result|
puts result[:name]
end
Errors
If an ABN is missing, invalid or expired - check the errors attribute.
client.errors
=> ["Business ABN 89107860122 has expired."]
Notes
-
Australian Business Register: www.abr.business.gov.au/
-
GUID Registration link: abr.business.gov.au/Documentation/UserGuideWebRegistration.aspx