Get All Listings

Get All Listings

get

Get All Listings

Retrieves all listings for a seller

Resource URL

https://api.stubhub.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

HTTP Basic

OAuth 2.0

API Key

Reset

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 Code
    Error Code
    Description
  • 404
    404

    Not Found

  • 401
    401

    Not authorized to access the listing

  • 403
    403

    Forbidden

  • 500
    500

    inventory.listings.systemError

Resource Summary

Security

Content Type

application/json

Category

Get All Listings

Working...