Accessing the Magento V2 API

Recently I’ve been working with Magento at work, and in particular with integrating with their API. Now, before I say anything more, I must say that I am always pleased when I see that these products do include some kind of API. The Magento one is a bit interesting, although there is some half-decent API documentation for the original API.

However they have then released a new version of the API, with very little documentation. So here are two calls – one to the v1 API and one to the v2 – which I hope will help illustrate the differences. The example I’ll give is the customer list functionality, including filtering the result set – because this was a total mystery when I started working with the v2 API!

    $options = array(
        "location" => 'http://magentoinstall.local/index.php/api/index/index/',
        "uri" => 'http://magentoinstall.local/api/'
    $client = new SoapClient(NULL, $options);

    $session = $client->login('user', 'pass');
    $list = $client->call($session, 'customer.list', array(array("customer_id" => "42")));

To make the same call with API version 2, we need to address the method in a different way, using the structure in the underlying code as the method name that we call, and CamelCasing those, like this:

   $client = new SoapClient('http:/magentoinstall.local/api/v2_soap?wsdl=1');

   $session = $client->login('user', 'pass');

    $filter = new StdClass();
    $filter->filter = array(array("key" => "customer_id", "value" => "42"));
    $list = $client->customerCustomerList($session, $filter);

I haven’t used either of the APIs a lot but once I was able to call the same method via both available services, I wanted to share the approach here in the hope that this would help someone else trying to solve the same problem. It is certainly not obvious from the documentation how to interact with the v2 API and I had some real puzzles getting the filtering working. These snippets are from my working code so I hope they are helpful to someone!

11 thoughts on “Accessing the Magento V2 API

  1. Hi Lorna,

    Thanks for your post! I just started working recently w/Magento’s API… Just out of curiousity, what version of Magento are you working with?


  2. I’ve been working with the API for Magento in recent weeks and I had a bit of a struggle explaining to the V2 API which attributes of a product I wanted to retrieve. Actually I had issues talking to the V2 API at all, but that’s a different post so I’ll

  3. Hi Lorna,

    Great post that has helped me a lot. Your code works perfectly for selecting the customer by ‘customer_id’ but I cannot figure out for the life of me how to get a list of customers based on ‘updated_at’.

    I have tried lots of variations of the following code:

    [geshi lang=php]
    $client = new SoapClient(‘http://mymagehost/index.php/api/v2_soap?wsdl=1’);
    $session = $client->login(‘username’, ‘password’);

    $filter = new StdClass();
    $filter->filter = array(array(“key” => “updated_at”, “value” => array(“key”=>”from”, “value”=>”2011-01-25 00:00:00”)));
    $list = $client->customerCustomerList($session, $filter);

    Can you shed some light on this for me?

    Thanks in advance!


  4. Dave: I’m sorry, I really can’t shed any more light on this. I’m not using magento any more so I don’t even have a testing platform to play with. Try asking your question on stackoverflow or a magento forum – and good luck finding an answer!

  5. Hello,

    Thank you for the illustration. I am currently working on the magneto v2 API in Everything works fine but i cannot make out how to filter orderlist.

    I would really be thankful if you can help me with this. I am kind of stuck over here

  6. If still someone has a problem with that…. correct $filter should be:

    $filter = array( ‘complex_filter’ => array( array( ‘key’ => ‘updated_at’, ‘value’ => array( ‘key’ => ‘from’, ‘value’ => ‘2011-01-25 00:00:00’ ) ) ) );

  7. Can someone please translate the complex filter syntax into pure XML for the soap request? This would be very helpful for anyone not using PHP for their API calls…

Leave a Reply

Please use [code] and [/code] around any source code you wish to share.

This site uses Akismet to reduce spam. Learn how your comment data is processed.