Get All Listings
get
Get All Listings
Resource URL
https://api.stubcloudprod.com/sellers /listings/v3
Query Parameters
Name | Values | Description |
---|---|---|
filters |
**Optional Parameter** Criteria used to refine the set of listings that are returned. Available filters are: EVENTDATE, INHANDDATE, DELIVERYOPTION, SALEENDDATE, EXTERNALLISTINGID DELIVERYOPTION can be: BARCODE, PDF, UPS, FEDEX, LMS, ROYALMAIL, DEUTSCHEPOST, WILLCALL, FLASHSEAT, COURIER, MOBILE_TICKET, LOCALDELIVERY, EXTERNAL_TRANSFER, OTHER Syntax: property:value Example: - `filters=EXTERNALLISTINGID:12345` returns all the listings for the seller that have external listing id as 12345. - `filters=DELIVERYOPTION:PDF` returns all listings that have a delivery option for tickets as PDF. - `filters=EVENTDATE:2019-10-15` returns all the listings for events that have a date of October 15, 2019. - `filters=EVENTDATE:2019-04-28 TO 2019-06-28` returns all listings for events between Apr 28, 2019 and June 28, 2019. Multiple filters can also be specified, seperated by comma (','). For example, filters=EVENT:9443919, DELIVERYOPTION:BARCODE **Default is no filtering** |
|
sort |
Optional Parameter A pair of space-separated tokens that specifies how the listings are sorted. - First token identifies property of the listing for sorting. You can specify any one of the following properties: EVENTDATE, INHANDDATE, DELIVERYOPTION, SALEENDDATE - Second token specifies the direction of the sort. You can specify one of the following types: Asc (Ascending order), Desc (Descending order) Syntax: first-token second-token Examples: - Single Value Sort: `sort=EVENTDATE Desc` to sort the event dates in decenting order. - Multiple Values Sort; `sort=INHANDDATE Asc, SALEENDDATE Desc, DELIVERYOPTION Asc`. In this example, the parameters are sorted in the following order: - By INHANDDATE date (in ascending order); - If any listings have the same INHANDDATE, then they are sorted by SALEENDDATE (in descending order); - If any listings are identical in both the INHANDDATE and SALEENDDATE, then they are sorted by the DELIVERYOPTION (in ascending order). |
|
start |
The index of the first listing, within the filtered and sorted set, that you wish to retrieve. Indices are 0-based. In other words, the syntax for specifying the first listing is `start=0`. |
|
rows |
The number of listings you wish to retrieve. Default is 200, which is also the maximum number of rows you can retrieve at a time with this API |
Header Parameters
Name | Values | Description |
---|---|---|
Authorization
(required) |
To generate an access token, use the [generateToken API](https://developer.stubhub.com/oauth/apis/post/accesstoken). Note that you will need to add a 'Bearer ' prefix to your access token. Otherwise, you'll get an 'Invalid Access Token' error |
|
Accept
(required) |
application/json |
Request Body
Make a request and see the response.
Make a request and see the response.
Make a request and see the response.
Response Error Details
-
HTTP CodeError CodeDescription
-
404404
Not Found
-
401401
Not authorized to access the listing
-
403403
Forbidden
-
500500
inventory.listings.systemError
Resource Summary |
|
Security |
|
Content Type |
application/json |
Category |
Get All Listings |
Working...