Skip to main content
Published: May 10 2007, 11:16:00 PMUpdated: November 28 2020, 3:42:25 PM

I see a number of SOAP samples that have varying parameters in the SOAP URL.
What exactly is required, and should be sent in the SOAP URL?

Required parameters in the SOAP URL

Summary

The SOAP URL must have the siteid and callname parameters as name-value pairs in the query string.
If the body of the SOAP request does not have a Version element, then the SOAP URL must also have the version name-value pair in the query string.


Detailed Description

There have been a number of query string parameters used in the SOAP URL since the creation of the SOAP API.
Some of them are no longer required, and some of them have no meaning.
Regardless of the version used for the api call, the SOAP URL should follow these 2 simple rules:
  • Include the siteid and callname parameters as name-value pairs in the query string.
    Here is an example:
    https://api.ebay.com/wsapi?callname=AddItem&siteid=0
  • If the body of the SOAP request contains the Version element, then nothing else is needed in the SOAP URL.
    If the body of the SOAP request does not contain the Version element, then the SOAP URL must include the version name-value pair in the query string.
    Here is an example:
    https://api.ebay.com/wsapi?callname=AddItem&siteid=0&version=511
No other parameters are needed in the SOAP URL.
This is true regardless of the WSDL version that the call is using.

How well did this answer your question?
Answers others found helpful