The GunBroker.com SOAP API will be deprecated. Please start using our REST API for your applications.

Buy and Sell on the Worlds Largest Firearms Auction Web Site

The following operations are supported. For a formal definition, please review the Service Description.

APIReleaseNotesThis call gives a history of the changes that are done to the API site.

AddItemCreate a new, uncommitted auction listing. Uncommitted auction listings are temporary auction listings that are hidden and not open for bidding. Uncommitted auctions are removed after a few days. You can test your software integration with our Web Service by creating auction listings without calling AddItemCommit. Call AddItemCommit to confirm that you want to create the auction listing and open the auction for bidding.

AddItemCommitFinalizes an uncommitted auction listing and confirms that you want the auction to be a live auction. Assigns the listing a real Item ID and opens the auction for bidding.

EditItemApplies edits to an item. This will update all fields specified by the WSDL whether or not they are sent with the request. If they are missing in the request, they will be treated as blank values.

EndItemEnd an auction. The same rules apply for ending an auction using this method as they do for ending an auction on the web site.

GetChildrenReturns all child item numbers for a particular item. A single item can be relisted multiple times and thus have multiple children. For example, if item 100 is relisted as 101, 105, and 106, calling this method and passing 100 would return an array containing 101, 105, and 106. This method only goes down one level in the item hierarchy. If item 101 is relisted as 109, then 109 would not be included in the result set if you passed 100 to this method. It would, however, be included if you called the method for item 101.

GetDocumentationURLGet the URL of the GB Web Service Documentation (No authentication required)

GetGunBrokerStateListGet the list of US State Names along with their 2 LETTER State Postal abbreviation (No authentication required)

GetItemGet the details of an auction. If you are the owner of the auction, all details including Reserve Price, etc. will be filled in. If you are NOT the owner of the auction then private attributes such as ReservePrice, AutoRelist and Listing Enhancements will be returned as Unspecified, Zero, or False.

GetItemHistoryReturns the list of items, if any, that were relisted until the result was the item passed in. For example, say item 100 is relisted as 102, item 102 is relisted as 108, and item 108 is relisted as item 109. When you call this method passing in 109 you will receive an array containing 108, 102, and 100.

GetMyAuctionsReturn a list of your own auctions. Use the TimeFrame parameter to change between Open and Closed auctions. Set the TimeFrame to 'Closed' and set the SoldType to 'Only' for this to return your Sold auctions.

GetMySoldOrdersThis call will return all orders where you are the seller. You can search for specific orders by setting search parameters in the MySoldOrdersRequestType.

GetOrderGets an order belonging to the orderID passed in. You must be the buyer or seller of the order to get the order returned.

GetSearchResultsSearch within the Open auctions using Keywords, CategoryID, UserID or a combination of those.

GetUserGet information about a user. Fill out either the UserID or UserName. If you have been involved in a transaction with that user, you will be provided their contact information. If you have not had any transactions with the user the call will fail with an error message, however if you fill out the UserName it will always succeed if the UserName is found and return only the UserID.