GunBroker.com REST API
DevKey: darkkermit    

/Listing/Edit/{itemID} GET

Retrieves information necessary to edit an item

URL
/Listing/Edit/{itemID}
Verb
GET

Headers

Header Data Type Valid Values Required Description
Content-Type string application/json YES The format your data will be sent to our site.
X-DevKey string string YES The devkey assigned to the developer.
X-AccessToken string string YES The token acquired from a POST to Users/AccessToken.

Output

Parameter Data Type Valid Values Description
AllowLayaway boolean true/false Whether or not this ListingItem allows for layaway.
AuctionID integer number The AuctionID associated with the Item indicating its creation source.
AutoAcceptPrice decimal positive # The minimum price for an offer to be automatically accepted.
AutoRejectPrice decimal positive # The maximum price for an offer to be automatically rejected
AutoRelist integer For an auction, this is the number of auto relists up to 999

For an auction to relist until sold, use 32000

For a fixed price listing to relist until quantity runs out, use 35000

Do not specify if no auto relist is required 		How the item should be relisted.
BidCount integer number >= 0 Number of bids on the item
BuyNowPrice decimal positive # The price you will sell the item for immediately. If used, the price must be greater than or equal to the Starting Bid and Reserve Price.
CanOffer boolean true/false Specifies whether the item is enabled for offer functionality. If true, you must also send AutoAcceptPrice and AutoRejectPrice.
Category integer positive # The single best category id for your item.
Characteristics Array of Characteristics An Array of values selected as this item's characteristics
Condition integer 1 - Factory New

2 - New Old Stock

3 - Used 		The condition of the item.
CountryCode string 2 character The ISO 2 character country code where the item is located. For example: Country:"US" for United States
Description string string The description of the item. If the description contains links or image references, they must all be secure (https://).
ExcludeStates string string Comma separated list of two digit States where the seller has indicated they will not ship.
FFLRequired boolean true/false Whether the item may only be shipped to a licensed Federal Firearms License (FFL) holder.
FixedPrice decimal positive # The price of each item when selling fixed price items.
HasCharacteristics boolean true/false Whether the item has characteristics associated with it.
GTIN string string The Global Trade Item Number (GTIN) of the item. If the GTIN is also a valid UPC and UPC is not specified, this will also update the UPC of the item.
InspectionPeriod integer 1 - AS IS - No refund or exchange

2 - No refund but item can be returned for exchange or store credit within fourteen days

3 - No refund but item can be returned for exchange or store credit within thirty days

4 - Three Days from the date the item is received

5 - Three Days from the date the item is received, including the cost of shipping

6 - Five Days from the date the item is received

7 - Five Days from the date the item is received, including the cost of shipping

8 - Seven Days from the date the item is received

9 - Seven Days from the date the item is received, including the cost of shipping

10 - Fourteen Days from the date the item is received

11 - Fourteen Days from the date the item is received, including the cost of shipping

12 - 30 day money back guarantee

13 - 30 day money back guarantee including the cost of shipping

14 - Factory Warranty 		The return policy / inspection period for this listing
ListingDuration integer 1 - One day.

3 - Three days.

4 - Four days.

5 - Five days.

6 - Six days.

7 - Seven days.

8 - Eight days.

9 - Nine days.

10 - Ten days.

11 - Eleven days.

12 - Twelve days.

13 - Thirteen days.

14 - Fourteen days.

30 - Thirty days. (Fixed price items only)

60 - Sixty days. (Fixed price items only)

90 - Ninety days. (Fixed price items only) 		How long before the listing ends.
Please note for 1 and 3 day listings, a Reserve Price is not allowed
MPN string string The manufacturing part number.
OfferCount integer number >= 0 Number of offers on the item
PaymentMethods object Amex - true/false

CertifiedCheck - true/false

Check - true/false

COD - true/false

Discover - true/false

Escrow - true/false

Financing - true/false

FreedomCoin - true/false (if allowed to sell)

MoneyOrder - true/false

PayPal - true/false

USPSMoneyOrder - true/false

VisaMastercard - true/false

 The payment methods you will accept. Each object property is a boolean. For example: 

    PaymentMethods: {
        "Amex": true,
        "CertifiedCheck": true,
        "Check": true,
        "COD": true,
        "Discover": true,
        "Escrow": true,
        "Financing": true,
        "FreedomCoin": true,
        "MoneyOrder": true,
        "PayPal": true,
        "USPSMoneyOrder": true,
        "VisaMastercard": true
    }
Pictures string Array of pictures to upload . All picture URLs must be secure. Specify if image is uploaded by Aurigma or a hosted image 

    "Pictures": [
    {
    "URL": "https://i.imgur.com/iFb6yBn.jpg",
    "IsAurigma": false,
    "ThumbnailName": "thumb-pix123456789.jpg"
    },
    {
    "URL": "https://pics.qa.kennesaw.gbhinc.com/GB_Temp/a5013e4c-a1f2-0442-dab4-d4a89be2daf4/~ah0000000111_1010387233_0000000001.jpg",
    "IsAurigma": true,
    "ThumbnailName": "thumb-pix123456780.jpg"
    }
    ]
PremiumFeatures object object The premium features you want for the item listing. Please note there are additional charges for these features. For example: 

PremiumFeatures: {
    HasViewCounter: true,
    IsFeaturedItem: true,
    IsHighlighted: true,
    IsShowCaseItem: true,
    IsTitleBoldface: true,
    IsSponsoredOffsite: true,
    IsSponsoredOnsite: true,
    ScheduledStartingDate: "2020-03-21T18:20:07Z",
    Subtitle: "Your Subtitle Text",
    TitleColor: "Red" // Must be: "Red", "Green", or "Blue"
}
NOTE: ScheduledStartingDate must be set in US Eastern Time ( GMT-5 ) Offical GunBroker Time
NOTE: ReservePrice will incur a fee. Please see the GunBroker Fees page for more information.
Prop65Warning string string Place the appropriate Proposition 65 messaging here if this applies to your business and product. For more information, visit https://www.p65warnings.ca.gov
Quantity integer positive # The quantity of items for sale. Must be 1 for auctions. Fixed price listings can have any quantity.
Reserve boolean true/false Whether the item has a reserve price.
ReservePrice decimal positive # The price the bidding must reach before you will sell the item.
Note: There is a fee for setting the reserve price. Please see the GunBroker Fees page for more information. Reserve price may not be set for 1 and 3 day listing durations.
SalesTax int 1 or 2 1 = See SalesTaxes field; 2 = Seller does not collect tax.
SalesTaxes object Array of SalesTax objects If you must collect sales tax, the states and tax rates you collect. For example: 
                
"SalesTaxes": [
    {
    "State": "GA",
    "TaxRate": 7.129,
    "IsShippingTaxed": true,
    "IsHandlingTaxed": true,
    "IsInsuranceTaxed": true,
    "IsMiscTaxed": true
    }
]
SerialNumber string string The serial number of the item.
ShippingClassCosts object object The shipping costs for each supported shipping class. For example: 

    ShippingClassCosts: {
    Overnight: 10.00,
    TwoDay: 9.00,
    ThreeDay: 8.00,
    Ground: 7.00,
    FirstClass: 6.00,
    Priority: 5.00,
    InStorePickup: 4.00,
    AlaskaHawaii: 3.00,
    Other: 2.00
    }
ShippingClassesSupported object Overnight - true/false

TwoDay - true/false

ThreeDay - true/false

Ground - true/false

FirstClass - true/false

Priority - true/false

InStorePickup - true/false

AlaskaHawaii - true/false

Other - true/false 		Required if not using a shipping profile. The shipping classes you support. Each object property is a boolean. For example: 

    ShippingClassesSupported: {
    "Overnight": true,
    "TwoDay": true,
    "ThreeDay": true,
    "Ground": true,
    "FirstClass": true,
    "Priority": true,
    "InStorePickup": true,
    "AlaskaHawaii": true,
    "Other": true
    }
ShippingProfileID integer positive # The shipping profile id to use to configure the available shipping options and costs for this item. If using a shipping profile, ShipTerms must be set to 16.
ShipTerms integer

2 - Seller Pays

4 - Buyer Pays Actual

8 - Buyer Pays Fixed

16 - Shipping Profile

 Specifies who pays for shipping on the item, or whether shipping fees are determined by a shipping profile.
SKU string string The Stock Keeping Unit (SKU) of the item.
StandardTextID int int The ID of the Standard Text for Additional Terms of Sale version linked to the item for StandardTextID
StartingBid decimal positive # The starting bid is the the least amount that a user will be able to bid on the item.
Thumbnail string string The item Thumbnail name.
Title string string The item title. 75 characters maximum, NO HTML, no asterisks, no quotes, NO ALL CAPS. Invalid characters will be stripped from the value entered.
UPC string string The Universal Product Code (UPC) of the item. A valid UPC will add additional searchable characteristics to most firearm listings.
Weight decimal positive # The weight of the item.
WeightUnit integer 1 - Pounds

2 - Kilograms 		The unit of weight for the item.
WillShipInternational boolean true/false Whether you will ship the item internationally.
ZIPCode string string The postal code where the item is located.