GunBroker.com REST API
DevKey (optional)     
Enter your DevKey for more detailed help!

/OrdersWon GET

Returns a user's won items as a List Response.

URL
/OrdersWon
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.

Input

NOTE: Variables to place in the query string of the request.

Parameter Data Type Valid Values Description
IsLayaway boolean true/false This is an optional filter that, when specified, will include (true) or exclude (false) Orders where the Buyer selected Layaway. If not specified, the filter will not be applied.
ItemID integer positive # ItemID of the item on the Order
Keywords string Search for Orders containing the provided keywords
OrdersModifiedSinceDate string Valid ISO 8601 DateTime format NOTE: Time entered is in UTC format.
OrderStatus integer 0 - All

1 - Pending Seller Review

2 - Pending Buyer Confirmation

3 - Pending Payment Received

4 - Pending Shipment

5 - Complete

6 - Cancelled

7 - Pending Buyer Review

10 - On Layaway

11 - Payment In Process

12 - Returned

13 - Refunded 		Status of the sold order. Default = 0 - All
OrderStatusExclude list of integers Valid Order Status values (see OrderStatus) Comma separated list of Order Statuses to exclude from the search results.
OrderStatusInclude list of integers Valid Order Status values (see OrderStatus) Comma separated list of Order Statuses to include in the search results.
SellerUserID integer positive # User ID of the Seller on the Order
SellerUserName string string UserName of the Seller on the Order
Sort integer Sorts are determined by status date.

0 - Order ID

1 - Seller Name

2 - Item ID

3 - Order Date

4 - Total Price

5 - Seller Reviewed

6 - Buyer Confirmed

7 - Payment Received

8 - FFL Received

9 - Item Shipped

10 - Order Complete

11 - On Layaway

12 - Payment In Process 		The field to sort on. Default = 0 - Order ID
SortOrder integer 0 - Ascending

1 - Descending 		Sort direction. Default = 1 - Descending
TimeFrame integer 1 - CreatedLast24

2 - CreatedLast48

3 - CreatedLastWeek

4 - CreatedLast2Weeks

5 - CreatedLast30Days

6 - CreatedLast60Days

7 - CreatedLast90Days

8 - All 		Using this parameter requires a valid X-AccessToken authentication header. This sets the time frame to search for. Default = 3 - CreatedLastWeek.
IsChargeback boolean true/false Indicates if the Order has a Chargeback recorded against it.

Optional PagingParameters

Output

If there are no errors with the input parameters, this call will respond with a 200 OK and the following data as serialized JSON

Parameter Data Type Valid Values Description
OrderID integer positive # ID of the Order
ItemIDs array[integers] array of positive # An array of itemIDs on the order
Buyer User Summary User Summary The Buyer of the item on the order
Seller User Summary User Summary The Seller of the item on the order
SellerName string string The name of the Seller on the order
SellerAddress1 string string Address line 1 for the Seller
SellerAddress2 string string Address line 2 for the Seller
SellerCity string string Address City for the Seller
SellerState string string Address State for the Seller
SellerPostalCode string string Address Postal Code for the Seller
SellerCountry string string Address Country Code for the Seller
SellerPhone string string Seller Phone number
SellerEmail string string Seller email address
ShipToName string string Name of the buyer
ShipToAddress1 string string Address1 of the buyer
ShipToAddress2 string string Address2 of the buyer
ShipToCity string string City of the buyer
ShipToState string string State or provinces of the buyer
ShipToPostalCode string string Postal code of the buyer
ShipToCountryCode string string Country of the buyer
ShipToPhone string string Ship To phone number
ShipToEmail string string Ship To email address
BuyerConfirmed boolean true/false Indicates if Buyer has Confirmed the order
BuyerReviewed boolean true/false Indicates if Buyer has reviewed the order
BuyerReviewCompleteDateUTC DateTime DateTime The date time (in UTC) the order was reviewed by the Buyer
CouponCode string string Coupon Code used in this order
CouponValue Decimal Decimal Value of the Coupon applied to this order
FFLReceived boolean true/false Indicates if Seller has Received FFL information
FFLReceivedDateUTC DateTime DateTime The date time (in UTC) the FFL was received by the Seller
ItemShipped boolean true/false Indicates if the item has been shipped
ShipDateUTC DateTime DateTime The date time (in UTC) the Item was shipped to the Buyer
LastModifiedDate DateTime Valid ISO 8601 DateTime format The time is returned in UTC.
LostCashDiscount decimal decimal Discount amount lost when using a credit card.
LostCashDiscountPercent decimal decimal Percentage Discount lost when using a credit card.
MiscCharge decimal decimal Miscellaneous charge for an order
MiscFee decimal decimal Miscellaneous State Fee on the Order
MiscFeeDescription string string Description for Miscellaneous State Fee on the Order
MiscFeeInfoBug string html Tooltip html for Miscellaneous State Fee on the Order
OnLayaway boolean true/false Indicates if the order is currently on Layaway
OrderCancelled boolean true/false Indicates if the order is canceled
OrderComplete boolean true/false Indicates if the order is complete
OrderRefunded boolean true/false Indicates if the order is refunded
OrderReturned boolean true/false Indicates if the order is returned
OrderDateUTC DateTime Valid ISO 8601 DateTime format The time is returned in UTC.
PartialRefund boolean true/false Indicates if a partial refund has been issued
PartialRefundDateUTC DateTime true/false The date time (UTC) the last partial refund was issued
PaymentInProcess boolean true/false Indicates if the order has a payment still in process
PaymentInProcessDateUTC DateTime DateTime The date time (in UTC) payment was initiated, if it was not immediately approved
PaymentReceived boolean true/false Indicates if Seller has received payment
PaymentReceivedDateUTC DateTime DateTime The date time (in UTC) payment was received by the Seller
RefundFailed boolean true/false Indicates if a refund has failed
RefundFailedDateUTC DateTime true/false The date time (UTC) the refund failed
SalesTaxTotal decimal decimal The total amount charged for sales taxes and fees for an order
SellerReviewed boolean true/false Indicates if Seller has reviewed the order
SellerReviewCompleteDateUTC DateTime DateTime The date time (in UTC) the Seller reviewed the Order
SellerForcedCompleteDateUTC DateTime DateTime The date time (in UTC) the Order was forced complete by the Seller
LayawayAcceptanceDateUTC DateTime DateTime The date time (in UTC) the layaway policy was accepted by the Buyer
ReturnedDateUTC DateTime Valid ISO 8601 DateTime format The time is returned in UTC.
RefundDateUTC DateTime Valid ISO 8601 DateTime format The time is returned in UTC. The time is returned in UTC.
ChargebackDateUTC DateTime Valid ISO 8601 DateTime format The is the date time (in UTC) a Chargeback was placed on the Order.
IsChargeback boolean true/false Indicates if the Order has a Chargeback recorded against it.
ShipClass key/pair ( integer/string ) 0 - None
1 - Overnight
2 - 2-Day
4 - 3-Day
8 - Ground
16 - USPS 1st Class
32 - USPS Priority Mail
64 - Other
128 - In-Store Pickup
256 - Alaska, Hawaii & Terr., Non-Continental US, Other 		What shipping carrier is shipping this order.
ShipCost decimal positive # Shipping Price on the Order
ShipTerms integer integer

A representation of who pays for shipping on the order

  • 1 = See item description / Additional terms of sale
  • 2 = Seller pays for shipping
  • 4 = Buyer pays actual shipping cost
  • 8 = Buyer pays fixed amount
  • 16 = Buyer pays estimated amount based on a shipping profile
ShipHandlingCost decimal positive # Shipping Handling Price on the Order
ShipInsuranceCost decimal positive # Shipping Insurance Price on the Order
TotalPrice decimal positive # Total Price on the Order
OrderItemsCollection Order Item Order Item The Order Item information for the items in the order

Links

Rel Description Condition
self The order
item The items on the order