twilio-ruby 5.5.1 → 5.6.0

data/lib/twilio-ruby/rest/api/v2010/account/conference.rb

@@ -365,7 +365,7 @@ module Twilio
             end
 
             ##
-            # @return [participant.Status] The status of the conference
+            # @return [recording.Status] The status of the conference
             def status
               @properties['status']
             end

data/lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb

@@ -63,8 +63,12 @@ module Twilio
               #   conference_recording_status_callback
               # @param [String] conference_recording_status_callback_method The
               #   conference_recording_status_callback_method
+              # @param [String] recording_status_callback_event The
+              #   recording_status_callback_event
+              # @param [String] conference_recording_status_callback_event The
+              #   conference_recording_status_callback_event
               # @return [ParticipantInstance] Newly created ParticipantInstance
-              def create(from: nil, to: nil, status_callback: :unset, status_callback_method: :unset, status_callback_event: :unset, timeout: :unset, record: :unset, muted: :unset, beep: :unset, start_conference_on_enter: :unset, end_conference_on_exit: :unset, wait_url: :unset, wait_method: :unset, early_media: :unset, max_participants: :unset, conference_record: :unset, conference_trim: :unset, conference_status_callback: :unset, conference_status_callback_method: :unset, conference_status_callback_event: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, sip_auth_username: :unset, sip_auth_password: :unset, region: :unset, conference_recording_status_callback: :unset, conference_recording_status_callback_method: :unset)
+              def create(from: nil, to: nil, status_callback: :unset, status_callback_method: :unset, status_callback_event: :unset, timeout: :unset, record: :unset, muted: :unset, beep: :unset, start_conference_on_enter: :unset, end_conference_on_exit: :unset, wait_url: :unset, wait_method: :unset, early_media: :unset, max_participants: :unset, conference_record: :unset, conference_trim: :unset, conference_status_callback: :unset, conference_status_callback_method: :unset, conference_status_callback_event: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, sip_auth_username: :unset, sip_auth_password: :unset, region: :unset, conference_recording_status_callback: :unset, conference_recording_status_callback_method: :unset, recording_status_callback_event: :unset, conference_recording_status_callback_event: :unset)
                 data = Twilio::Values.of({
                     'From' => from,
                     'To' => to,
@@ -94,6 +98,8 @@ module Twilio
                     'Region' => region,
                     'ConferenceRecordingStatusCallback' => conference_recording_status_callback,
                     'ConferenceRecordingStatusCallbackMethod' => conference_recording_status_callback_method,
+                    'RecordingStatusCallbackEvent' => Twilio.serialize_list(recording_status_callback_event) { |e| e },
+                    'ConferenceRecordingStatusCallbackEvent' => Twilio.serialize_list(conference_recording_status_callback_event) { |e| e },
                 })
 
                 payload = @version.create(

data/lib/twilio-ruby/rest/api/v2010/account/recording.rb

@@ -293,9 +293,10 @@ module Twilio
                   'status' => payload['status'],
                   'channels' => payload['channels'].to_i,
                   'source' => payload['source'],
+                  'error_code' => payload['error_code'] == nil ? payload['error_code'] : payload['error_code'].to_i,
                   'uri' => payload['uri'],
                   'encryption_details' => payload['encryption_details'],
-                  'error_code' => payload['error_code'] == nil ? payload['error_code'] : payload['error_code'].to_i,
+                  'subresource_uris' => payload['subresource_uris'],
               }
 
               # Context
@@ -327,7 +328,7 @@ module Twilio
             end
 
             ##
-            # @return [String] The call during which the recording was made.
+            # @return [String] The unique id for the call leg that corresponds to the recording.
             def call_sid
               @properties['call_sid']
             end
@@ -357,35 +358,41 @@ module Twilio
             end
 
             ##
-            # @return [String] The price
+            # @return [String] The one-time cost of creating this recording.
             def price
               @properties['price']
             end
 
             ##
-            # @return [String] The price_unit
+            # @return [String] The currency used in the Price property.
             def price_unit
               @properties['price_unit']
             end
 
             ##
-            # @return [transcription.Status] The status
+            # @return [transcription.Status] The status of the recording.
             def status
               @properties['status']
             end
 
             ##
-            # @return [String] The channels
+            # @return [String] The number of channels in the final recording file as an integer.
             def channels
               @properties['channels']
             end
 
             ##
-            # @return [recording.Source] The source
+            # @return [recording.Source] The way in which this recording was created.
             def source
               @properties['source']
             end
 
+            ##
+            # @return [String] More information about the recording failure, if Status is failed.
+            def error_code
+              @properties['error_code']
+            end
+
             ##
             # @return [String] The URI for this resource
             def uri
@@ -399,9 +406,9 @@ module Twilio
             end
 
             ##
-            # @return [String] More information about the recording failure, if Status is failed.
-            def error_code
-              @properties['error_code']
+            # @return [String] The subresource_uris
+            def subresource_uris
+              @properties['subresource_uris']
             end
 
             ##

data/lib/twilio-ruby/rest/preview/hosted_numbers/hosted_number_order.rb

@@ -198,8 +198,14 @@ module Twilio
           #   phone number.
           # @param [String] email Optional. Email of the owner of this phone number that is
           #   being hosted.
+          # @param [hosted_number_order.VerificationType] verification_type Optional. The
+          #   method used for verifying ownership of the number to be hosted. One of
+          #   phone-call (default) or phone-bill.
+          # @param [String] verification_document_sid Optional. The unique sid identifier of
+          #   the Identity Document that represents the document for verifying ownership of
+          #   the number to be hosted. Required when VerificationType is phone-bill.
           # @return [HostedNumberOrderInstance] Newly created HostedNumberOrderInstance
-          def create(phone_number: nil, sms_capability: nil, account_sid: :unset, friendly_name: :unset, unique_name: :unset, cc_emails: :unset, sms_url: :unset, sms_method: :unset, sms_fallback_url: :unset, sms_fallback_method: :unset, status_callback_url: :unset, status_callback_method: :unset, sms_application_sid: :unset, address_sid: :unset, email: :unset)
+          def create(phone_number: nil, sms_capability: nil, account_sid: :unset, friendly_name: :unset, unique_name: :unset, cc_emails: :unset, sms_url: :unset, sms_method: :unset, sms_fallback_url: :unset, sms_fallback_method: :unset, status_callback_url: :unset, status_callback_method: :unset, sms_application_sid: :unset, address_sid: :unset, email: :unset, verification_type: :unset, verification_document_sid: :unset)
             data = Twilio::Values.of({
                 'PhoneNumber' => phone_number,
                 'SmsCapability' => sms_capability,
@@ -216,6 +222,8 @@ module Twilio
                 'SmsApplicationSid' => sms_application_sid,
                 'AddressSid' => address_sid,
                 'Email' => email,
+                'VerificationType' => verification_type,
+                'VerificationDocumentSid' => verification_document_sid,
             })
 
             payload = @version.create(
@@ -319,8 +327,14 @@ module Twilio
           #   User can only update this to `pending-loa` or `pending-verification`.
           # @param [String] verification_code A verification code that is given to the user
           #   via a phone call to the phone number that is being hosted.
+          # @param [hosted_number_order.VerificationType] verification_type Optional. The
+          #   method used for verifying ownership of the number to be hosted. One of
+          #   phone-call (default) or phone-bill.
+          # @param [String] verification_document_sid Optional. The unique sid identifier of
+          #   the Identity Document that represents the document for verifying ownership of
+          #   the number to be hosted. Required when VerificationType is phone-bill.
           # @return [HostedNumberOrderInstance] Updated HostedNumberOrderInstance
-          def update(friendly_name: :unset, unique_name: :unset, email: :unset, cc_emails: :unset, status: :unset, verification_code: :unset)
+          def update(friendly_name: :unset, unique_name: :unset, email: :unset, cc_emails: :unset, status: :unset, verification_code: :unset, verification_type: :unset, verification_document_sid: :unset)
             data = Twilio::Values.of({
                 'FriendlyName' => friendly_name,
                 'UniqueName' => unique_name,
@@ -328,6 +342,8 @@ module Twilio
                 'CcEmails' => Twilio.serialize_list(cc_emails) { |e| e },
                 'Status' => status,
                 'VerificationCode' => verification_code,
+                'VerificationType' => verification_type,
+                'VerificationDocumentSid' => verification_document_sid,
             })
 
             payload = @version.update(
@@ -378,6 +394,8 @@ module Twilio
                 'email' => payload['email'],
                 'cc_emails' => payload['cc_emails'],
                 'url' => payload['url'],
+                'verification_type' => payload['verification_type'],
+                'verification_document_sid' => payload['verification_document_sid'],
             }
 
             # Context
@@ -492,6 +510,18 @@ module Twilio
             @properties['url']
           end
 
+          ##
+          # @return [hosted_number_order.VerificationType] The method used for verifying ownership of the number to be hosted.
+          def verification_type
+            @properties['verification_type']
+          end
+
+          ##
+          # @return [String] Verification Document Sid.
+          def verification_document_sid
+            @properties['verification_document_sid']
+          end
+
           ##
           # Fetch a HostedNumberOrderInstance
           # @return [HostedNumberOrderInstance] Fetched HostedNumberOrderInstance
@@ -521,8 +551,14 @@ module Twilio
           #   User can only update this to `pending-loa` or `pending-verification`.
           # @param [String] verification_code A verification code that is given to the user
           #   via a phone call to the phone number that is being hosted.
+          # @param [hosted_number_order.VerificationType] verification_type Optional. The
+          #   method used for verifying ownership of the number to be hosted. One of
+          #   phone-call (default) or phone-bill.
+          # @param [String] verification_document_sid Optional. The unique sid identifier of
+          #   the Identity Document that represents the document for verifying ownership of
+          #   the number to be hosted. Required when VerificationType is phone-bill.
           # @return [HostedNumberOrderInstance] Updated HostedNumberOrderInstance
-          def update(friendly_name: :unset, unique_name: :unset, email: :unset, cc_emails: :unset, status: :unset, verification_code: :unset)
+          def update(friendly_name: :unset, unique_name: :unset, email: :unset, cc_emails: :unset, status: :unset, verification_code: :unset, verification_type: :unset, verification_document_sid: :unset)
             context.update(
                 friendly_name: friendly_name,
                 unique_name: unique_name,
@@ -530,6 +566,8 @@ module Twilio
                 cc_emails: cc_emails,
                 status: status,
                 verification_code: verification_code,
+                verification_type: verification_type,
+                verification_document_sid: verification_document_sid,
             )
           end
 

data/lib/twilio-ruby/rest/proxy/v1/service/session.rb

@@ -32,7 +32,7 @@ module Twilio
             # @param [String] unique_name Provides a unique and addressable name to be
             #   assigned to this Session, assigned by the developer, to be optionally used in
             #   addition to SID.
-            # @param [session.Status] status The Status of this Session. One of `in-progess`,
+            # @param [session.Status] status The Status of this Session. One of `in-progress`,
             #   `closed`, `failed`, `unknown` or `completed`.
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit.  Default is no limit
@@ -52,7 +52,7 @@ module Twilio
             # @param [String] unique_name Provides a unique and addressable name to be
             #   assigned to this Session, assigned by the developer, to be optionally used in
             #   addition to SID.
-            # @param [session.Status] status The Status of this Session. One of `in-progess`,
+            # @param [session.Status] status The Status of this Session. One of `in-progress`,
             #   `closed`, `failed`, `unknown` or `completed`.
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit. Default is no limit.
@@ -89,7 +89,7 @@ module Twilio
             # @param [String] unique_name Provides a unique and addressable name to be
             #   assigned to this Session, assigned by the developer, to be optionally used in
             #   addition to SID.
-            # @param [session.Status] status The Status of this Session. One of `in-progess`,
+            # @param [session.Status] status The Status of this Session. One of `in-progress`,
             #   `closed`, `failed`, `unknown` or `completed`.
             # @param [String] page_token PageToken provided by the API
             # @param [Integer] page_number Page Number, this value is simply for client state
@@ -135,7 +135,7 @@ module Twilio
             # @param [String] ttl The Time to Live for a Session, in seconds.
             # @param [session.Mode] mode The Mode of this Session. One of `message-only`,
             #   `voice-only` or `voice-and-message`.
-            # @param [session.Status] status The Status of this Session. One of `in-progess`,
+            # @param [session.Status] status The Status of this Session. One of `in-progress`,
             #   `closed`, `failed`, `unknown` or `completed`.
             # @param [Hash] participants A list of phone numbers to add to this Session.
             # @return [SessionInstance] Newly created SessionInstance
@@ -249,7 +249,7 @@ module Twilio
             # @param [String] ttl The Time to Live for a Session, in seconds.
             # @param [session.Mode] mode The Mode of this Session. One of `message-only`,
             #   `voice-only` or `voice-and-message`.
-            # @param [session.Status] status The Status of this Session. One of `in-progess`,
+            # @param [session.Status] status The Status of this Session. One of `in-progress`,
             #   `closed`, `failed`, `unknown` or `completed`.
             # @param [Hash] participants A list of phone numbers to add to this Session.
             # @return [SessionInstance] Updated SessionInstance
@@ -493,7 +493,7 @@ module Twilio
             # @param [String] ttl The Time to Live for a Session, in seconds.
             # @param [session.Mode] mode The Mode of this Session. One of `message-only`,
             #   `voice-only` or `voice-and-message`.
-            # @param [session.Status] status The Status of this Session. One of `in-progess`,
+            # @param [session.Status] status The Status of this Session. One of `in-progress`,
             #   `closed`, `failed`, `unknown` or `completed`.
             # @param [Hash] participants A list of phone numbers to add to this Session.
             # @return [SessionInstance] Updated SessionInstance

data/lib/twilio-ruby/twiml/messaging_response.rb

@@ -23,9 +23,10 @@ module Twilio
       # from:: Phone Number to send Message from
       # action:: Action URL
       # method:: Action URL Method
+      # status_callback:: Status callback URL. Deprecated in favor of action.
       # keyword_args:: additional attributes
-      def message(body: nil, to: nil, from: nil, action: nil, method: nil, **keyword_args)
-        message = Message.new(body: body, to: to, from: from, action: action, method: method, **keyword_args)
+      def message(body: nil, to: nil, from: nil, action: nil, method: nil, status_callback: nil, **keyword_args)
+        message = Message.new(body: body, to: to, from: from, action: action, method: method, status_callback: status_callback, **keyword_args)
 
         yield(message) if block_given?
         append(message)

data/lib/twilio-ruby/twiml/voice_response.rb

@@ -29,11 +29,12 @@ module Twilio
       # trim:: Trim the recording
       # recording_status_callback:: Recording status callback URL
       # recording_status_callback_method:: Recording status callback URL method
+      # recording_status_callback_event:: Recording status callback events
       # answer_on_bridge:: Preserve the ringing behavior of the inbound call until the Dialed call picks up
       # ring_tone:: Ringtone allows you to override the ringback tone that Twilio will play back to the caller while executing the Dial
       # keyword_args:: additional attributes
-      def dial(number: nil, action: nil, method: nil, timeout: nil, hangup_on_star: nil, time_limit: nil, caller_id: nil, record: nil, trim: nil, recording_status_callback: nil, recording_status_callback_method: nil, answer_on_bridge: nil, ring_tone: nil, **keyword_args)
-        dial = Dial.new(number: number, action: action, method: method, timeout: timeout, hangup_on_star: hangup_on_star, time_limit: time_limit, caller_id: caller_id, record: record, trim: trim, recording_status_callback: recording_status_callback, recording_status_callback_method: recording_status_callback_method, answer_on_bridge: answer_on_bridge, ring_tone: ring_tone, **keyword_args)
+      def dial(number: nil, action: nil, method: nil, timeout: nil, hangup_on_star: nil, time_limit: nil, caller_id: nil, record: nil, trim: nil, recording_status_callback: nil, recording_status_callback_method: nil, recording_status_callback_event: nil, answer_on_bridge: nil, ring_tone: nil, **keyword_args)
+        dial = Dial.new(number: number, action: action, method: method, timeout: timeout, hangup_on_star: hangup_on_star, time_limit: time_limit, caller_id: caller_id, record: record, trim: trim, recording_status_callback: recording_status_callback, recording_status_callback_method: recording_status_callback_method, recording_status_callback_event: recording_status_callback_event, answer_on_bridge: answer_on_bridge, ring_tone: ring_tone, **keyword_args)
 
         yield(dial) if block_given?
         append(dial)
@@ -353,9 +354,11 @@ module Twilio
       ##
       # Create a new <Task> element
       # body:: TaskRouter task attributes
+      # priority:: Task priority
+      # timeout:: Timeout associated with task
       # keyword_args:: additional attributes
-      def task(body, **keyword_args)
-        append(Task.new(body, **keyword_args))
+      def task(body, priority: nil, timeout: nil, **keyword_args)
+        append(Task.new(body, priority: priority, timeout: timeout, **keyword_args))
       end
     end
 
@@ -423,10 +426,11 @@ module Twilio
       # status_callback_method:: Status callback URL method
       # recording_status_callback:: Recording status callback URL
       # recording_status_callback_method:: Recording status callback URL method
+      # recording_status_callback_event:: Recording status callback events
       # event_callback_url:: Event callback URL
       # keyword_args:: additional attributes
-      def conference(name, muted: nil, beep: nil, start_conference_on_enter: nil, end_conference_on_exit: nil, wait_url: nil, wait_method: nil, max_participants: nil, record: nil, region: nil, whisper: nil, trim: nil, status_callback_event: nil, status_callback: nil, status_callback_method: nil, recording_status_callback: nil, recording_status_callback_method: nil, event_callback_url: nil, **keyword_args)
-        append(Conference.new(name, muted: muted, beep: beep, start_conference_on_enter: start_conference_on_enter, end_conference_on_exit: end_conference_on_exit, wait_url: wait_url, wait_method: wait_method, max_participants: max_participants, record: record, region: region, whisper: whisper, trim: trim, status_callback_event: status_callback_event, status_callback: status_callback, status_callback_method: status_callback_method, recording_status_callback: recording_status_callback, recording_status_callback_method: recording_status_callback_method, event_callback_url: event_callback_url, **keyword_args))
+      def conference(name, muted: nil, beep: nil, start_conference_on_enter: nil, end_conference_on_exit: nil, wait_url: nil, wait_method: nil, max_participants: nil, record: nil, region: nil, whisper: nil, trim: nil, status_callback_event: nil, status_callback: nil, status_callback_method: nil, recording_status_callback: nil, recording_status_callback_method: nil, recording_status_callback_event: nil, event_callback_url: nil, **keyword_args)
+        append(Conference.new(name, muted: muted, beep: beep, start_conference_on_enter: start_conference_on_enter, end_conference_on_exit: end_conference_on_exit, wait_url: wait_url, wait_method: wait_method, max_participants: max_participants, record: record, region: region, whisper: whisper, trim: trim, status_callback_event: status_callback_event, status_callback: status_callback, status_callback_method: status_callback_method, recording_status_callback: recording_status_callback, recording_status_callback_method: recording_status_callback_method, recording_status_callback_event: recording_status_callback_event, event_callback_url: event_callback_url, **keyword_args))
       end
 
       ##

data/lib/twilio-ruby/version.rb

@@ -1,3 +1,3 @@
 module Twilio
-    VERSION = '5.5.1'
+    VERSION = '5.6.0'
 end

data/spec/integration/api/v2010/account/available_phone_number/machine_to_machine_spec.rb

@@ -0,0 +1,101 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+
+require 'spec_helper.rb'
+
+describe 'MachineToMachine' do
+  it "can read" do
+    @holodeck.mock(Twilio::Response.new(500, ''))
+
+    expect {
+      @client.api.v2010.accounts("ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") \
+                       .available_phone_numbers("US") \
+                       .machine_to_machine.list()
+    }.to raise_exception(Twilio::REST::TwilioError)
+
+    values = {}
+    expect(
+    @holodeck.has_request?(Holodeck::Request.new(
+        method: 'get',
+        url: 'https://api.twilio.com/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/AvailablePhoneNumbers/US/MachineToMachine.json',
+    ))).to eq(true)
+  end
+
+  it "receives read_full responses" do
+    @holodeck.mock(Twilio::Response.new(
+        200,
+      %q[
+      {
+          "available_phone_numbers": [
+              {
+                  "address_requirements": "none",
+                  "beta": false,
+                  "capabilities": {
+                      "mms": false,
+                      "sms": true,
+                      "voice": false
+                  },
+                  "friendly_name": "+4759440374",
+                  "iso_country": "NO",
+                  "lata": null,
+                  "latitude": null,
+                  "locality": null,
+                  "longitude": null,
+                  "phone_number": "+4759440374",
+                  "postal_code": null,
+                  "rate_center": null,
+                  "region": null
+              }
+          ],
+          "end": 1,
+          "first_page_uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/AvailablePhoneNumbers/US/MachineToMachine.json?PageSize=50&Page=0",
+          "last_page_uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/AvailablePhoneNumbers/US/MachineToMachine.json?PageSize=50&Page=0",
+          "next_page_uri": null,
+          "num_pages": 1,
+          "page": 0,
+          "page_size": 50,
+          "previous_page_uri": null,
+          "start": 0,
+          "total": 1,
+          "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/AvailablePhoneNumbers/US/MachineToMachine.json?PageSize=1"
+      }
+      ]
+    ))
+
+    actual = @client.api.v2010.accounts("ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") \
+                              .available_phone_numbers("US") \
+                              .machine_to_machine.list()
+
+    expect(actual).to_not eq(nil)
+  end
+
+  it "receives read_empty responses" do
+    @holodeck.mock(Twilio::Response.new(
+        200,
+      %q[
+      {
+          "available_phone_numbers": [],
+          "first_page_uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/AvailablePhoneNumbers/US/MachineToMachine.json?PageSize=50&Page=0",
+          "last_page_uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/AvailablePhoneNumbers/US/MachineToMachine.json?PageSize=50&Page=0",
+          "next_page_uri": null,
+          "num_pages": 1,
+          "page": 0,
+          "page_size": 50,
+          "previous_page_uri": null,
+          "start": 0,
+          "total": 1,
+          "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/AvailablePhoneNumbers/US/MachineToMachine.json?PageSize=1"
+      }
+      ]
+    ))
+
+    actual = @client.api.v2010.accounts("ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") \
+                              .available_phone_numbers("US") \
+                              .machine_to_machine.list()
+
+    expect(actual).to_not eq(nil)
+  end
+end

data/spec/integration/api/v2010/account/available_phone_number/national_spec.rb

@@ -0,0 +1,101 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+
+require 'spec_helper.rb'
+
+describe 'National' do
+  it "can read" do
+    @holodeck.mock(Twilio::Response.new(500, ''))
+
+    expect {
+      @client.api.v2010.accounts("ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") \
+                       .available_phone_numbers("US") \
+                       .national.list()
+    }.to raise_exception(Twilio::REST::TwilioError)
+
+    values = {}
+    expect(
+    @holodeck.has_request?(Holodeck::Request.new(
+        method: 'get',
+        url: 'https://api.twilio.com/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/AvailablePhoneNumbers/US/National.json',
+    ))).to eq(true)
+  end
+
+  it "receives read_full responses" do
+    @holodeck.mock(Twilio::Response.new(
+        200,
+      %q[
+      {
+          "available_phone_numbers": [
+              {
+                  "address_requirements": "none",
+                  "beta": false,
+                  "capabilities": {
+                      "mms": false,
+                      "sms": true,
+                      "voice": false
+                  },
+                  "friendly_name": "+4759440374",
+                  "iso_country": "NO",
+                  "lata": null,
+                  "latitude": null,
+                  "locality": null,
+                  "longitude": null,
+                  "phone_number": "+4759440374",
+                  "postal_code": null,
+                  "rate_center": null,
+                  "region": null
+              }
+          ],
+          "end": 1,
+          "first_page_uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/AvailablePhoneNumbers/US/National.json?PageSize=50&Page=0",
+          "last_page_uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/AvailablePhoneNumbers/US/National.json?PageSize=50&Page=0",
+          "next_page_uri": null,
+          "num_pages": 1,
+          "page": 0,
+          "page_size": 50,
+          "previous_page_uri": null,
+          "start": 0,
+          "total": 1,
+          "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/AvailablePhoneNumbers/US/National.json?PageSize=1"
+      }
+      ]
+    ))
+
+    actual = @client.api.v2010.accounts("ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") \
+                              .available_phone_numbers("US") \
+                              .national.list()
+
+    expect(actual).to_not eq(nil)
+  end
+
+  it "receives read_empty responses" do
+    @holodeck.mock(Twilio::Response.new(
+        200,
+      %q[
+      {
+          "available_phone_numbers": [],
+          "first_page_uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/AvailablePhoneNumbers/US/National.json?PageSize=50&Page=0",
+          "last_page_uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/AvailablePhoneNumbers/US/National.json?PageSize=50&Page=0",
+          "next_page_uri": null,
+          "num_pages": 1,
+          "page": 0,
+          "page_size": 50,
+          "previous_page_uri": null,
+          "start": 0,
+          "total": 1,
+          "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/AvailablePhoneNumbers/US/National.json?PageSize=1"
+      }
+      ]
+    ))
+
+    actual = @client.api.v2010.accounts("ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") \
+                              .available_phone_numbers("US") \
+                              .national.list()
+
+    expect(actual).to_not eq(nil)
+  end
+end