Website logo

Add a photo to a listing

Adds a photo to an auction. The currently authenticated user must be the seller.

This API can currently only add a single photo to an auction without any photos. It is recommended that photos are instead specified when creating a listing or when using the edit listing API (both APIs can handle multiple photos).

Requires Authentication? Yes
Permission Required: MyTradeMeWrite: Maintain your watchlist, answer questions and post comments.
Supported Formats: XML, JSON
Rate Limited? Yes

URL parameters

photoId Integer (required)

The ID of the photo to add.

listingId Integer (required)

The ID of the listing to add the photo to.

file_format Enumeration (required) The format of the response.
xml Serialize responses into XML.
json Serialize responses into JSON.



The ID of the added photo.

Status Enumeration

The status of the photo operation.

Failure 0

The photo action was a failure.

Success 1

The photo action was a success.

NotMemberPhoto 2

The photo is not owned by the member.

NotMemberAuction 3

The auction is not owned by the member.

NotFound 4

The auction was not found.

PhotoId Long Integer

The ID of the photo.

Description String or null

A description of the error message, if an error occurred.

Example XML Response (switch to JSON)

<PhotoResponse xmlns="">

Example JSON Response (switch to XML)

  "Status": 0,
  "PhotoId": 123,
  "Description": "ABC"