magento soap api v2 - get Customer with newsletter subscription

magento soap api v2 - get Customer with newsletter subscription

September 23, 2026 · Illustrated author avatarBy Stefan Bogdanescu
magento soap api v2 - get Customer with newsletter subscription

Filtering Magento Customers by Newsletter Subscription Using SOAP API v2

Are you looking to retrieve only those customers from your Magento store who have opted into the newsletter subscription? The Magento SOAP API v2 provides an efficient way to filter customers based on specific attributes, including the newsletter field.

In this guide, we will walk through the process of retrieving all customers with their newsletter subscriptions activated using the SOAP API v2. Let’s dive right in!

Understanding the Problem

The current implementation fetches all customers without any filtering applied:

$proxy = new SoapClient('http://magentohost/api/v2_soap/?wsdl');
$sessionId = $proxy->login('apiUser', 'apiKey');
$params = array(
    'sessionId' => $session_id,
    'filters' => null
);
$allCustomers = $proxy->customerCustomerList($params);

This code snippet retrieves all customers regardless of their newsletter subscription status.

Filtering Customers by Newsletter Subscription

To filter customers based on the newsletter attribute, we need to use the $filters parameter in the customerCustomerList SOAP call. The newsletter field accepts boolean values ‘0’ (Opted Out) and ‘1’ (Opted In).

Here’s how you can modify the existing code to fetch only customers who have subscribed to the newsletter:

$proxy = new SoapClient('http://magentohost/api/v2_soap/?wsdl');
$sessionId = $proxy->login('apiUser', 'apiKey');

$params = array(
    'sessionId' => $session_id,
    'filters' => array(
        array(
            'field' => 'newsletter',
            'value' => 1
        )
    )
);

$subscribedCustomers = $proxy->customerCustomerList($params);

In this updated code:

  • We create an associative array containing the filter details.
  • The field is set to 'newsletter' to target the specific attribute we want to filter by.
  • The value is set to 1, which represents customers who have opted in to the newsletter subscription.

Exploring Additional Filters

The SOAP API v2 allows you to apply multiple filters using arrays within the $filters parameter. You can combine various attributes such as created_at, modified_at, group_id, and more.

For example, if you want to retrieve customers who subscribed to the newsletter within a specific date range:

$params = array(
    'sessionId' => $session_id,
    'filters' => array(
        array(
            'field' => 'newsletter',
            'value' => 1
        ),
        array(
            'field' => 'created_at',
            'from' => '2022-01-01T00:00:00Z',
            'to' => '2022-12-31T23:59:59Z'
        )
    )
);

In this example, we added an additional filter for the created_at field with a specified date range. This will return all customers who subscribed to the newsletter between January 1, 2022 and December 31, 2022.

Conclusion

Retrieving Magento customers based on their newsletter subscription status is a common requirement when integrating with external systems or performing data analysis. By leveraging the SOAP API v2’s filtering capabilities, you can easily fetch targeted customer data efficiently.

Remember to replace 'http://magentohost/api/v2_soap/?wsdl' and the authentication credentials ('apiUser' and 'apiKey') with your actual Magento store URL and valid credentials.

For more information on working with the Magento SOAP API v2, you can refer to the official documentation or explore relevant tutorials at Laravel Company.

Happy coding!

API Themes Customers Errors

Our network