Merge pull request #332 from EasyPost/SHPE-484_verify_carrier

feat: add verify_carrier address param

Author: Justintime50

CHANGELOG.md

@@ -1,9 +1,10 @@
 # CHANGELOG
 
-## v7.1.0 (2025-06-18)
+## v7.2.0 (2025-11-10)
 
 - Adds support for `UspsShipAccount`
 - Adds `tracker.retrieve_batch` function
+- Adds `verify_carrier` address param
 
 ## v7.1.0 (2025-06-18)
 

VERSION

@@ -1 +1 @@
-7.1.0
+7.2.0

lib/easypost/services/address.rb

@@ -5,7 +5,7 @@ class EasyPost::Services::Address < EasyPost::Services::Service
 
   # Create an address.
   def create(params = {})
-    address = params.reject { |k, _| [:verify, :verify_strict].include?(k) }
+    address = params.reject { |k, _| [:verify, :verify_strict, :verify_carrier].include?(k) }
 
     wrapped_params = { address: address }
 
@@ -17,15 +17,24 @@ def create(params = {})
       wrapped_params[:verify_strict] = params[:verify_strict]
     end
 
+    if params[:verify_carrier]
+      wrapped_params[:verify_carrier] = params[:verify_carrier]
+    end
+
     response = @client.make_request(:post, 'addresses', params)
 
     EasyPost::InternalUtilities::Json.convert_json_to_object(response, MODEL_CLASS)
   end
 
   # Create and verify an Address in one call.
   def create_and_verify(params = {})
-    wrapped_params = {}
-    wrapped_params[:address] = params
+    address = params.reject { |k, _| [:verify_carrier].include?(k) }
+
+    wrapped_params = { address: address }
+
+    if params[:verify_carrier]
+      wrapped_params[:verify_carrier] = params[:verify_carrier]
+    end
 
     response = @client.make_request(:post, 'addresses/create_and_verify', wrapped_params)
 

spec/address_spec.rb

@@ -73,6 +73,19 @@
       expect(address).to be_an_instance_of(EasyPost::Models::Address)
       expect(address.verifications.delivery.success).to be false
     end
+
+    it 'creates an address with verify_carrier param' do
+      address_data = Fixture.incorrect_address
+
+      address_data[:verify] = true
+      address_data[:verify_carrier] = 'UPS'
+      address = client.address.create(address_data)
+
+      expect(address).to be_an_instance_of(EasyPost::Models::Address)
+
+      expect(address.verifications.delivery.errors[0].message).to eq('Address not found')
+      expect(address.verifications.zip4.errors[0].message).to eq('Address not found')
+    end
   end
 
   describe '.retrieve' do
@@ -143,6 +156,18 @@
     rescue EasyPost::Errors::InvalidRequestError => e
       expect(e.message).to eq('Unable to verify address.')
     end
+
+    it 'creates and verifies an address with verify_carrier param' do
+      address_data = Fixture.incorrect_address
+
+      address_data[:verify_carrier] = 'UPS'
+      address = client.address.create_and_verify(address_data)
+
+      expect(address).to be_an_instance_of(EasyPost::Models::Address)
+
+      expect(address.verifications.delivery.errors[0].message).to eq('Address not found')
+      expect(address.verifications.zip4.errors[0].message).to eq('Address not found')
+    end
   end
 
   describe '.verify' do