Description

Simple, fast, way to lookup a north american phone number carrier.

Quick Start

The easiest way to get started is to install it via RubyGems. You can do this easily:

$ gem install carrierlookup

or Gemfile:

gem 'carrierlookup'

You can now use the library to lookup carriers this way:

require 'carrierlookup'

@data = Carrier::Lookup::Perform.new
@data.lookup(
    :number => "1 (415) 453-1123"
)

Rest API

http://carrier.cardup.co/lookup?number=14154531123

Format

Number can be in any format:

4154531123
(415) 453-1123
1 (415) 453-1123

Response

Rest API:

json : success

{
    "status": 0
    "carrier": "TELUS Mobility",
    "city": "Winnipeg",
    "state": "",
    "createdAt": "2013-06-17 15:18:41 -0600"
}

json : not found

{ 
    "status" : -1
}

Gem:

hash : success

{
    "carrier"=>"NEW CINGULAR WIRELESS PCS, LLC", "city"=>"JUNEAU", "state" => "AK", createdAt"=>"2013-06-17 15:06:50 -0600"
}

hash : not found

nil

License

See the included LICENSE file for details.