SOAP Response Format

To return the response in SOAP format, send a parameter "format" in the request with a value of "soap".

A simple call to the echo service returns this:

<?xml version="1.0" encoding="utf-8" ?>
<s:Envelope
	xmlns:s="http://www.w3.org/2003/05/soap-envelope"
	xmlns:xsi="http://www.w3.org/1999/XMLSchema-instance"
	xmlns:xsd="http://www.w3.org/1999/XMLSchema"
>
	<s:Body>
		<x:FlickrResponse xmlns:x="urn:flickr">
			[escaped-xml-payload]
		</x:FlickrResponse>
	</s:Body>
</s:Envelope>

If an error occurs, the following is returned:

<?xml version="1.0" encoding="utf-8" ?>
<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope">
	<s:Body>
		<s:Fault>
			<faultcode>flickr.error.[error-code]</faultcode>
			<faultstring>[error-message]</faultstring>
			<faultactor>
				http://www.flickr.com/services/soap/
			</faultactor>
			<details>
				Please see 
				http://www.flickr.com/services/docs/ 
				for more details
			</details>
		</s:Fault>
	</s:Body>
</s:Envelope>

You can see a demo response here.

You can find out more about SOAP at www.w3.org/TR/soap/.

Alternate SOAP Response Format

By specifying a format value of "soap2", flickr can return API responses as unescaped XML, putting the response straight inside the envelope by setting the response's namespace. The error response is identical, but the sucess response is as follows:

<?xml version="1.0" encoding="utf-8" ?>
<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope">
	<s:Body>
		<FlickrResponse xmlns="/ns/api#">
			[xml-payload]
		</FlickrResponse>
	</s:Body>
</s:Envelope>

This response type is new and experimental and may not be supported in future versions.

You can see a demo response here.