3.1.4.15 GetList

  • Article

The GetList operation is used to retrieve properties and fields for a specified list.

 <wsdl:operation name="GetList">
     <wsdl:input message="GetListSoapIn" />
     <wsdl:output message="GetListSoapOut" />
 </wsdl:operation>

The protocol client sends a GetListSoapIn request message (section 3.1.4.15.1.1) and the protocol server MUST respond with a GetListSoapOut response message (section 3.1.4.15.1.2), as follows:

  1. If the specified listName is a valid GUID and corresponds to the identification of a list on the site, the protocol server MUST return a GetListResponse element (section 3.1.4.15.2.2).

  2. If the specified listName is not a valid GUID or does not correspond to the identification of a list on the site, check if the listName corresponds to the list title of a list on the site, and if so the protocol server MUST return a GetListResponse element.

  3. If the specified listName does not correspond to a list from either of these checks, the protocol server SHOULD<55> return a SOAP fault with error code 0x82000006. This indicates that the list does not exist or might have been deleted by another user.