README.md in twilio-ruby-4.2.0 vs README.md in twilio-ruby-4.2.1
- old
+ new
@@ -9,11 +9,11 @@
## Installation
To install using [Bundler][bundler] grab the latest stable version:
```ruby
-gem 'twilio-ruby', '~> 4.1.0'
+gem 'twilio-ruby', '~> 4.2.1'
```
To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
```bash
@@ -145,10 +145,34 @@
```
There is a slightly more detailed document in the [Capability][capability]
section of the wiki.
+## Lookup Phone Number information
+
+You can look up details on phone numbers with the Lookups API.
+
+```ruby
+require 'twilio-ruby'
+
+# put your own credentials here
+account_sid = 'ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
+auth_token = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
+
+# set up a client to talk to the Twilio REST API
+@lookups_client = Twilio::REST::LookupsClient.new account_sid, auth_token
+
+# lookup a number
+number = @lookups_client.phone_numbers.get('+14159341234')
+
+# investigate the number
+number.national_format
+# => "(415) 934-1234"
+number.country_code
+# => "US"
+```
+
## Getting Started With TwiML
TwiML support is based on the [Builder][builder] library. You can construct a
TwiML response like this:
@@ -199,10 +223,10 @@
If you've instead found a bug in the library or would like new features added, go ahead and open issues or pull requests against this repo!
## More Information
There are more detailed examples in the included [examples][examples]
-directory. Also for thoose upgrading, the [upgrade guide][upgrade] is available in the [twilio-ruby github wiki][wiki].
+directory. Also for those upgrading, the [upgrade guide][upgrade] is available in the [twilio-ruby github wiki][wiki].
[capability]: https://github.com/twilio/twilio-ruby/wiki/Capability
[builder]: http://builder.rubyforge.org/
[examples]: https://github.com/twilio/twilio-ruby/blob/master/examples
[documentation]: http://twilio-ruby.readthedocs.org/en/latest