Add recipient validation support

README.md

@@ -893,8 +893,25 @@ simple_spark.recipient_lists.delete(your_list_id)
 
 <a href="https://developers.sparkpost.com/api/recipient-lists/#recipient-lists-delete-delete-a-recipient-list" target="_blank">see SparkPost API Documentation</a>
 
+
+### Recipient Validation
+
+#### Validate
+
+Validates a single recipient by email address.
+
+```ruby
+simple_spark.recipient_validation.validate('[email protected]')
+```
+
+<a href="https://developers.sparkpost.com/api/recipient-validation/#recipient-validation-get-email-address-validation" target="_blank">see SparkPost API Documentation</a>
+
 ## Changelog
 
+### 1.0.13
+
+- Add Recipient Validation Endpoint
+
 ### 1.0.12 Fix param name on suppression list https://github.com/leadmachineapp/simple_spark/pull/27
 
 ### 1.0.10 / 1.0.11 Minor documentation updates

lib/simple_spark.rb

@@ -11,6 +11,7 @@
 require 'simple_spark/endpoints/events'
 require 'simple_spark/endpoints/webhooks'
 require 'simple_spark/endpoints/recipient_lists'
+require 'simple_spark/endpoints/recipient_validation'
 require 'simple_spark/endpoints/relay_webhooks'
 require 'simple_spark/endpoints/subaccounts'
 require 'simple_spark/endpoints/suppression_list'

lib/simple_spark/client.rb

@@ -155,5 +155,9 @@ def suppression_list
     def recipient_lists
       Endpoints::RecipientLists.new(self)
     end
+
+    def recipient_validation
+      Endpoints::RecipientValidation.new(self)
+    end
   end
 end

lib/simple_spark/endpoints/recipient_validation.rb

@@ -0,0 +1,31 @@
+module SimpleSpark
+  module Endpoints
+    # Provides access to the /recipient-validation endpoint
+    # @note Example validation
+    # {
+    #   "valid": false,
+    #   "result": "undeliverable",
+    #   "reason": "Invalid Domain",
+    #   "is_role": false,
+    #   "is_disposable": false,
+    #   "is_free": false
+    # }
+    # @note See: https://developers.sparkpost.com/api/recipient-validation/
+    class RecipientValidation
+      attr_accessor :client
+
+      def initialize(client)
+        @client = client
+      end
+
+      # Validate a recipient email address.
+      # @param address [String] the email address to validate
+      # @return [Hash] a Recipient Validation hash object
+      # @note See: https://developers.sparkpost.com/api/recipient-validation/#recipient-validation-get-email-address-validation
+      def validate(address)
+        address = @client.url_encode(address)
+        @client.call(method: :get, path: "recipient-validation/single/#{address}")
+      end
+    end
+  end
+end

lib/simple_spark/version.rb

@@ -1,3 +1,3 @@
 module SimpleSpark
-  VERSION = "1.0.12"
+  VERSION = "1.0.13"
 end

spec/simple_spark/client_spec.rb

@@ -104,6 +104,10 @@
         specify { expect(client.recipient_lists.class).to eq(SimpleSpark::Endpoints::RecipientLists) }
       end
 
+      context 'recipient_validation' do
+        specify { expect(client.recipient_validation.class).to eq(SimpleSpark::Endpoints::RecipientValidation) }
+      end
+
     end
   end
 end