Skip to main content
logo
Documentation Powered by Redocly

StubHub Inventory API (2.249.0.0)

SellerListings

List tickets, update your listings and search your inventory.

Update a seller listing

Authorizations:
OAuth2
path Parameters
listingId
required
integer <int64>
Request Body schema: application/json
One of
(Money (object or null))

The price of each ticket in the listing.

(Money (object or null))

The amount that the seller will receive for each ticket sold.

(SeatingRequest (object or null))

The seating information for the ticket(s) in this listing. For PATCH Requests, you need to pass in all the fields of a Seating to update, even when you only need to update some of the fields. Otherwise the rest of the fields will be set to empty.

(Money (object or null))

The price printed on the ticket, not including any booking fees.

ticket_type
string or null

The type of ticket(s) in this listing.

split_type
string or null

The way that the ticket(s) are allowed to be split up when sold.

number_of_tickets
integer or null <int32>

The number of tickets available for purchase.

display_number_of_tickets
integer or null <int32>

The number of tickets that should be displayed to buyers as available for purchase.

ticket_location_address_id
integer or null <int32>

The identifier of the address where the ticket(s) are located.

listing_note_ids
Array of integers or null <int32>

An array of listing note identifiers that provides additional notes on the listing

in_hand_at
string or null <date-time>

The date when the seller will have the tickets in hand.

external_id
string or null

An identifier that has been assigned to the listing in an external inventory management system.

notes
string or null

A comma-separated string of additional notes about the listing

instant_delivery
boolean or null
published
boolean or null

True when the listing should be published; Otherwise, false.

lms_optin
boolean or null

True when the listing should be opted into Last Minute Sales; Otherwise, false.

eticket_ids
Array of integers or null <int32>

A array of the identifiers of the E-Tickets to be assigned to the listing.

external_event_information
Array of objects or null (SellerListingExternalEventInformation)

Information about the listing's event on other platforms.

(Money (object or null))

The purchase price paid by the seller for each ticket in the listing.

(Money (object or null))

The total purchase price paid by the seller.

sales_tax_paid
boolean or null

True if the seller already paid sales tax for the ticket(s); otherwise, false.

barcodes
Array of objects or null (BarcodeInformation2)

Barcode(s) for the ticket(s) in this listing.

Responses

Response Schema: application/hal+json
id
integer or null <int64>

The listing identifier.

created_at
string or null <date-time>

The date when the listing was created.

number_of_tickets
integer or null <int32>

The number of tickets available for purchase.

(SeatingDetail (object or null))

The seating information for the ticket(s) in this listing.

(SeatingDetail (object or null))

The seating information that will be displayed to buyers for the ticket(s) in this listing.

(Money (object or null))

The price of each ticket in the listing.

updated_at
string or null <date-time>

The date when the listing was last updated.

external_id
string or null

An identifier that has been assigned to the listing in an external inventory management system.

expires_at
string or null <date-time>

The date when the listing will be automatically unpublished from the marketplace.

display_number_of_tickets
integer or null <int32>

The number of tickets that should be displayed to buyers as available for purchase.

(Money (object or null))

The price printed on the ticket, not including any booking fees.

(Money (object or null))

The amount that the seller will receive for each ticket sold.

in_hand_at
string or null <date-time>

The date when the seller will have the tickets in hand.

is_ticket_concierge
boolean

Whether the listing represents a shorted ticket

is_auto_po
boolean

Whether a listing was automatically generated from a purchase order

barcodes
Array of objects or null (BarcodeInformation)

Barcode(s) for the ticket(s) in this listing.

instant_delivery
boolean or null
undeliverable
boolean or null

Shipment of the ticket to the buyer cannot be guaranteed before the event. To increase the deliverability of electronic type tickets, preupload them (e.g. pre-upload barcodes or PDF files.) To increase deliverability of paper tickets, opt your tickets into our LMS program.

(Money (object or null))

The purchase price paid by the seller for each ticket in the listing.

(Money (object or null))

The total purchase price paid by the seller.

sales_tax_paid
boolean or null

True if the seller already paid sales tax for the ticket(s); otherwise, false.

(SellerListingLinks (object or null))
(SellerListingEmbeddedResources (object or null))

Request samples

Content type
application/json
{
  • "ticket_price": {
    },
  • "ticket_proceeds": {
    },
  • "seating": {
    },
  • "face_value": {
    },
  • "ticket_type": "string",
  • "split_type": "string",
  • "number_of_tickets": 0,
  • "display_number_of_tickets": 0,
  • "ticket_location_address_id": 0,
  • "listing_note_ids": [
    ],
  • "in_hand_at": "2019-08-24T14:15:22Z",
  • "external_id": "string",
  • "notes": "string",
  • "instant_delivery": true,
  • "published": true,
  • "lms_optin": true,
  • "eticket_ids": [
    ],
  • "external_event_information": [
    ],
  • "purchase_price_per_ticket": {
    },
  • "total_purchase_price": {
    },
  • "sales_tax_paid": true,
  • "barcodes": [
    ]
}

Response samples

Content type
application/hal+json
{
  • "id": 0,
  • "created_at": "2019-08-24T14:15:22Z",
  • "number_of_tickets": 0,
  • "seating": {
    },
  • "display_seating": {
    },
  • "ticket_price": {
    },
  • "updated_at": "2019-08-24T14:15:22Z",
  • "external_id": "string",
  • "expires_at": "2019-08-24T14:15:22Z",
  • "display_number_of_tickets": 0,
  • "face_value": {
    },
  • "ticket_proceeds": {
    },
  • "in_hand_at": "2019-08-24T14:15:22Z",
  • "is_ticket_concierge": true,
  • "is_auto_po": true,
  • "barcodes": [
    ],
  • "instant_delivery": true,
  • "undeliverable": true,
  • "purchase_price_per_ticket": {
    },
  • "total_purchase_price": {
    },
  • "sales_tax_paid": true,
  • "_links": {
    },
  • "_embedded": {
    }
}

Get a seller listing

Authorizations:
OAuth2
path Parameters
listingId
required
integer <int64>

Responses

Response Schema: application/hal+json
id
integer or null <int64>

The listing identifier.

created_at
string or null <date-time>

The date when the listing was created.

number_of_tickets
integer or null <int32>

The number of tickets available for purchase.

(SeatingDetail (object or null))

The seating information for the ticket(s) in this listing.

(SeatingDetail (object or null))

The seating information that will be displayed to buyers for the ticket(s) in this listing.

(Money (object or null))

The price of each ticket in the listing.

updated_at
string or null <date-time>

The date when the listing was last updated.

external_id
string or null

An identifier that has been assigned to the listing in an external inventory management system.

expires_at
string or null <date-time>

The date when the listing will be automatically unpublished from the marketplace.

display_number_of_tickets
integer or null <int32>

The number of tickets that should be displayed to buyers as available for purchase.

(Money (object or null))

The price printed on the ticket, not including any booking fees.

(Money (object or null))

The amount that the seller will receive for each ticket sold.

in_hand_at
string or null <date-time>

The date when the seller will have the tickets in hand.

is_ticket_concierge
boolean

Whether the listing represents a shorted ticket

is_auto_po
boolean

Whether a listing was automatically generated from a purchase order

barcodes
Array of objects or null (BarcodeInformation)

Barcode(s) for the ticket(s) in this listing.

instant_delivery
boolean or null
undeliverable
boolean or null

Shipment of the ticket to the buyer cannot be guaranteed before the event. To increase the deliverability of electronic type tickets, preupload them (e.g. pre-upload barcodes or PDF files.) To increase deliverability of paper tickets, opt your tickets into our LMS program.

(Money (object or null))

The purchase price paid by the seller for each ticket in the listing.

(Money (object or null))

The total purchase price paid by the seller.

sales_tax_paid
boolean or null

True if the seller already paid sales tax for the ticket(s); otherwise, false.

(SellerListingLinks (object or null))
(SellerListingEmbeddedResources (object or null))

Response samples

Content type
application/hal+json
{
  • "id": 0,
  • "created_at": "2019-08-24T14:15:22Z",
  • "number_of_tickets": 0,
  • "seating": {
    },
  • "display_seating": {
    },
  • "ticket_price": {
    },
  • "updated_at": "2019-08-24T14:15:22Z",
  • "external_id": "string",
  • "expires_at": "2019-08-24T14:15:22Z",
  • "display_number_of_tickets": 0,
  • "face_value": {
    },
  • "ticket_proceeds": {
    },
  • "in_hand_at": "2019-08-24T14:15:22Z",
  • "is_ticket_concierge": true,
  • "is_auto_po": true,
  • "barcodes": [
    ],
  • "instant_delivery": true,
  • "undeliverable": true,
  • "purchase_price_per_ticket": {
    },
  • "total_purchase_price": {
    },
  • "sales_tax_paid": true,
  • "_links": {
    },
  • "_embedded": {
    }
}

Delete a seller listing

Authorizations:
OAuth2
path Parameters
listingId
required
integer <int64>

Responses

Response samples

Content type
application/hal+json
{
  • "code": "string",
  • "message": "string",
  • "errors": {
    }
}

List seller listings (recent updates)

List seller listings for the authenticated user that have been created or updated over a certain period of time.

Authorizations:
OAuth2
query Parameters
updated_since
string <date-time>

Filters the response to only return items that have been updated since the given timestamp

Responses

Response Schema: application/hal+json
total_items
integer or null <int32>
page
integer or null <int32>
page_size
integer or null <int32>
(SellerListingsLinks (object or null))
(SellerListingsEmbeddedResources (object or null))

Response samples

Content type
application/hal+json
{
  • "total_items": 0,
  • "page": 0,
  • "page_size": 0,
  • "_links": {
    },
  • "_embedded": {
    }
}

List seller listings

List seller listings for the authenticated user.

Authorizations:
OAuth2
query Parameters
event_id
integer or null <int32>
requested_event_id
string or null <guid>
page
integer <int32>

Specifies which page of data to retrieve.

page_size
integer <int32>

Set custom page sizes on response.

updated_since
string <date-time>

Filters the response to only return items that have been updated since the given timestamp

sort
string

Determines the ordering of items. A comma-separated string containing available_tickets, created_at, event_date, event_name, expiration_date, price, resource_version, orticket_availability_date.

Responses

Response Schema: application/hal+json
total_items
integer or null <int32>
page
integer or null <int32>
page_size
integer or null <int32>
(SellerListingsLinks (object or null))
(SellerListingsEmbeddedResources (object or null))

Response samples

Content type
application/hal+json
{
  • "total_items": 0,
  • "page": 0,
  • "page_size": 0,
  • "_links": {
    },
  • "_embedded": {
    }
}

Create a seller listing for a requested event

Creates a seller listing for an event requested by the current user.

Authorizations:
OAuth2
Request Body schema: application/json
One of
(Money (object or null))

The price of each ticket in the listing.

(Money (object or null))

The amount that the seller will receive for each ticket sold.

required
(SeatingRequest (object or null))

The seating information for the ticket(s) in this listing. For PATCH Requests, you need to pass in all the fields of a Seating to update, even when you only need to update some of the fields. Otherwise the rest of the fields will be set to empty.

(Money (object or null))

The price printed on the ticket, not including any booking fees.

ticket_type
required
string or null

The type of ticket(s) in this listing.

split_type
required
string or null

The way that the ticket(s) are allowed to be split up when sold.

number_of_tickets
required
integer or null <int32>

The number of tickets available for purchase.

display_number_of_tickets
integer or null <int32>

The number of tickets that should be displayed to buyers as available for purchase.

ticket_location_address_id
integer or null <int32>

The identifier of the address where the ticket(s) are located.

listing_note_ids
Array of integers or null <int32>

An array of listing note identifiers that provides additional notes on the listing

in_hand_at
string or null <date-time>

The date when the seller will have the tickets in hand.

external_id
string or null

An identifier that has been assigned to the listing in an external inventory management system.

notes
string or null

A comma-separated string of additional notes about the listing

instant_delivery
boolean or null
published
boolean or null

True when the listing should be published; Otherwise, false.

lms_optin
boolean or null

True when the listing should be opted into Last Minute Sales; Otherwise, false.

eticket_ids
Array of integers or null <int32>

A array of the identifiers of the E-Tickets to be assigned to the listing.

relist_transaction_id
integer or null <int32>

Used when relisting tickets previously purchased on Stubhub marketplace. Include the transaction ID in the id value field.

external_event_information
Array of objects or null (SellerListingExternalEventInformation)

Information about the listing's event on other platforms.

(Money (object or null))

The purchase price paid by the seller for each ticket in the listing.

(Money (object or null))

The total purchase price paid by the seller.

sales_tax_paid
boolean or null

True if the seller already paid sales tax for the ticket(s); otherwise, false.

is_ticket_concierge
boolean or null

Whether the listing represents a shorted ticket

is_auto_po
boolean or null

Whether a listing was automatically generated from a purchase order

barcodes
Array of objects or null (BarcodeInformation2)

Barcode(s) for the ticket(s) in this listing.

(EventRequest (object or null))

The event information.

(VenueRequest (object or null))

The venue where the event will take place.

(CountryRequest (object or null))

The country where the event will take place.

Responses

Response Schema: application/hal+json
id
integer or null <int64>

The listing identifier.

created_at
string or null <date-time>

The date when the listing was created.

number_of_tickets
integer or null <int32>

The number of tickets available for purchase.

(SeatingDetail (object or null))

The seating information for the ticket(s) in this listing.

(SeatingDetail (object or null))

The seating information that will be displayed to buyers for the ticket(s) in this listing.

(Money (object or null))

The price of each ticket in the listing.

updated_at
string or null <date-time>

The date when the listing was last updated.

external_id
string or null

An identifier that has been assigned to the listing in an external inventory management system.

expires_at
string or null <date-time>

The date when the listing will be automatically unpublished from the marketplace.

display_number_of_tickets
integer or null <int32>

The number of tickets that should be displayed to buyers as available for purchase.

(Money (object or null))

The price printed on the ticket, not including any booking fees.

(Money (object or null))

The amount that the seller will receive for each ticket sold.

in_hand_at
string or null <date-time>

The date when the seller will have the tickets in hand.

is_ticket_concierge
boolean

Whether the listing represents a shorted ticket

is_auto_po
boolean

Whether a listing was automatically generated from a purchase order

barcodes
Array of objects or null (BarcodeInformation)

Barcode(s) for the ticket(s) in this listing.

instant_delivery
boolean or null
undeliverable
boolean or null

Shipment of the ticket to the buyer cannot be guaranteed before the event. To increase the deliverability of electronic type tickets, preupload them (e.g. pre-upload barcodes or PDF files.) To increase deliverability of paper tickets, opt your tickets into our LMS program.

(Money (object or null))

The purchase price paid by the seller for each ticket in the listing.

(Money (object or null))

The total purchase price paid by the seller.

sales_tax_paid
boolean or null

True if the seller already paid sales tax for the ticket(s); otherwise, false.

(SellerListingLinks (object or null))
(SellerListingEmbeddedResources (object or null))

Request samples

Content type
application/json
{
  • "ticket_price": {
    },
  • "ticket_proceeds": {
    },
  • "seating": {
    },
  • "face_value": {
    },
  • "ticket_type": "string",
  • "split_type": "string",
  • "number_of_tickets": 0,
  • "display_number_of_tickets": 0,
  • "ticket_location_address_id": 0,
  • "listing_note_ids": [
    ],
  • "in_hand_at": "2019-08-24T14:15:22Z",
  • "external_id": "string",
  • "notes": "string",
  • "instant_delivery": true,
  • "published": true,
  • "lms_optin": true,
  • "eticket_ids": [
    ],
  • "relist_transaction_id": 0,
  • "external_event_information": [
    ],
  • "purchase_price_per_ticket": {
    },
  • "total_purchase_price": {
    },
  • "sales_tax_paid": true,
  • "is_ticket_concierge": true,
  • "is_auto_po": true,
  • "barcodes": [
    ],
  • "event": {
    },
  • "venue": {
    },
  • "country": {
    }
}

Response samples

Content type
application/hal+json
{
  • "id": 0,
  • "created_at": "2019-08-24T14:15:22Z",
  • "number_of_tickets": 0,
  • "seating": {
    },
  • "display_seating": {
    },
  • "ticket_price": {
    },
  • "updated_at": "2019-08-24T14:15:22Z",
  • "external_id": "string",
  • "expires_at": "2019-08-24T14:15:22Z",
  • "display_number_of_tickets": 0,
  • "face_value": {
    },
  • "ticket_proceeds": {
    },
  • "in_hand_at": "2019-08-24T14:15:22Z",
  • "is_ticket_concierge": true,
  • "is_auto_po": true,
  • "barcodes": [
    ],
  • "instant_delivery": true,
  • "undeliverable": true,
  • "purchase_price_per_ticket": {
    },
  • "total_purchase_price": {
    },
  • "sales_tax_paid": true,
  • "_links": {
    },
  • "_embedded": {
    }
}

Create a seller listing

Authorizations:
OAuth2
path Parameters
eventId
required
integer <int32>
Request Body schema: application/json
One of
(Money (object or null))

The price of each ticket in the listing.

(Money (object or null))

The amount that the seller will receive for each ticket sold.

required
(SeatingRequest (object or null))

The seating information for the ticket(s) in this listing. For PATCH Requests, you need to pass in all the fields of a Seating to update, even when you only need to update some of the fields. Otherwise the rest of the fields will be set to empty.

(Money (object or null))

The price printed on the ticket, not including any booking fees.

ticket_type
required
string or null

The type of ticket(s) in this listing.

split_type
required
string or null

The way that the ticket(s) are allowed to be split up when sold.

number_of_tickets
required
integer or null <int32>

The number of tickets available for purchase.

display_number_of_tickets
integer or null <int32>

The number of tickets that should be displayed to buyers as available for purchase.

ticket_location_address_id
integer or null <int32>

The identifier of the address where the ticket(s) are located.

listing_note_ids
Array of integers or null <int32>

An array of listing note identifiers that provides additional notes on the listing

in_hand_at
string or null <date-time>

The date when the seller will have the tickets in hand.

external_id
string or null

An identifier that has been assigned to the listing in an external inventory management system.

notes
string or null

A comma-separated string of additional notes about the listing

instant_delivery
boolean or null
published
boolean or null

True when the listing should be published; Otherwise, false.

lms_optin
boolean or null

True when the listing should be opted into Last Minute Sales; Otherwise, false.

eticket_ids
Array of integers or null <int32>

A array of the identifiers of the E-Tickets to be assigned to the listing.

relist_transaction_id
integer or null <int32>

Used when relisting tickets previously purchased on Stubhub marketplace. Include the transaction ID in the id value field.

external_event_information
Array of objects or null (SellerListingExternalEventInformation)

Information about the listing's event on other platforms.

(Money (object or null))

The purchase price paid by the seller for each ticket in the listing.

(Money (object or null))

The total purchase price paid by the seller.

sales_tax_paid
boolean or null

True if the seller already paid sales tax for the ticket(s); otherwise, false.

is_ticket_concierge
boolean or null

Whether the listing represents a shorted ticket

is_auto_po
boolean or null

Whether a listing was automatically generated from a purchase order

barcodes
Array of objects or null (BarcodeInformation2)

Barcode(s) for the ticket(s) in this listing.

Responses

Response Schema: application/hal+json
id
integer or null <int64>

The listing identifier.

created_at
string or null <date-time>

The date when the listing was created.

number_of_tickets
integer or null <int32>

The number of tickets available for purchase.

(SeatingDetail (object or null))

The seating information for the ticket(s) in this listing.

(SeatingDetail (object or null))

The seating information that will be displayed to buyers for the ticket(s) in this listing.

(Money (object or null))

The price of each ticket in the listing.

updated_at
string or null <date-time>

The date when the listing was last updated.

external_id
string or null

An identifier that has been assigned to the listing in an external inventory management system.

expires_at
string or null <date-time>

The date when the listing will be automatically unpublished from the marketplace.

display_number_of_tickets
integer or null <int32>

The number of tickets that should be displayed to buyers as available for purchase.

(Money (object or null))

The price printed on the ticket, not including any booking fees.

(Money (object or null))

The amount that the seller will receive for each ticket sold.

in_hand_at
string or null <date-time>

The date when the seller will have the tickets in hand.

is_ticket_concierge
boolean

Whether the listing represents a shorted ticket

is_auto_po
boolean

Whether a listing was automatically generated from a purchase order

barcodes
Array of objects or null (BarcodeInformation)

Barcode(s) for the ticket(s) in this listing.

instant_delivery
boolean or null
undeliverable
boolean or null

Shipment of the ticket to the buyer cannot be guaranteed before the event. To increase the deliverability of electronic type tickets, preupload them (e.g. pre-upload barcodes or PDF files.) To increase deliverability of paper tickets, opt your tickets into our LMS program.

(Money (object or null))

The purchase price paid by the seller for each ticket in the listing.

(Money (object or null))

The total purchase price paid by the seller.

sales_tax_paid
boolean or null

True if the seller already paid sales tax for the ticket(s); otherwise, false.

(SellerListingLinks (object or null))
(SellerListingEmbeddedResources (object or null))

Request samples

Content type
application/json
{
  • "ticket_price": {
    },
  • "ticket_proceeds": {
    },
  • "seating": {
    },
  • "face_value": {
    },
  • "ticket_type": "string",
  • "split_type": "string",
  • "number_of_tickets": 0,
  • "display_number_of_tickets": 0,
  • "ticket_location_address_id": 0,
  • "listing_note_ids": [
    ],
  • "in_hand_at": "2019-08-24T14:15:22Z",
  • "external_id": "string",
  • "notes": "string",
  • "instant_delivery": true,
  • "published": true,
  • "lms_optin": true,
  • "eticket_ids": [
    ],
  • "relist_transaction_id": 0,
  • "external_event_information": [
    ],
  • "purchase_price_per_ticket": {
    },
  • "total_purchase_price": {
    },
  • "sales_tax_paid": true,
  • "is_ticket_concierge": true,
  • "is_auto_po": true,
  • "barcodes": [
    ]
}

Response samples

Content type
application/hal+json
{
  • "id": 0,
  • "created_at": "2019-08-24T14:15:22Z",
  • "number_of_tickets": 0,
  • "seating": {
    },
  • "display_seating": {
    },
  • "ticket_price": {
    },
  • "updated_at": "2019-08-24T14:15:22Z",
  • "external_id": "string",
  • "expires_at": "2019-08-24T14:15:22Z",
  • "display_number_of_tickets": 0,
  • "face_value": {
    },
  • "ticket_proceeds": {
    },
  • "in_hand_at": "2019-08-24T14:15:22Z",
  • "is_ticket_concierge": true,
  • "is_auto_po": true,
  • "barcodes": [
    ],
  • "instant_delivery": true,
  • "undeliverable": true,
  • "purchase_price_per_ticket": {
    },
  • "total_purchase_price": {
    },
  • "sales_tax_paid": true,
  • "_links": {
    },
  • "_embedded": {
    }
}

SellerListings (External Id)

Manage your inventory using identifiers from an external inventory management system.

Get a seller listing by external ID

Get a seller listing by identifier that has been assigned to the listing in an external inventory management system.

Authorizations:
OAuth2
path Parameters
externallistingId
required
string or null

Responses

Response Schema: application/hal+json
id
integer or null <int64>

The listing identifier.

created_at
string or null <date-time>

The date when the listing was created.

number_of_tickets
integer or null <int32>

The number of tickets available for purchase.

(SeatingDetail (object or null))

The seating information for the ticket(s) in this listing.

(SeatingDetail (object or null))

The seating information that will be displayed to buyers for the ticket(s) in this listing.

(Money (object or null))

The price of each ticket in the listing.

updated_at
string or null <date-time>

The date when the listing was last updated.

external_id
string or null

An identifier that has been assigned to the listing in an external inventory management system.

expires_at
string or null <date-time>

The date when the listing will be automatically unpublished from the marketplace.

display_number_of_tickets
integer or null <int32>

The number of tickets that should be displayed to buyers as available for purchase.

(Money (object or null))

The price printed on the ticket, not including any booking fees.

(Money (object or null))

The amount that the seller will receive for each ticket sold.

in_hand_at
string or null <date-time>

The date when the seller will have the tickets in hand.

is_ticket_concierge
boolean

Whether the listing represents a shorted ticket

is_auto_po
boolean

Whether a listing was automatically generated from a purchase order

barcodes
Array of objects or null (BarcodeInformation)

Barcode(s) for the ticket(s) in this listing.

instant_delivery
boolean or null
undeliverable
boolean or null

Shipment of the ticket to the buyer cannot be guaranteed before the event. To increase the deliverability of electronic type tickets, preupload them (e.g. pre-upload barcodes or PDF files.) To increase deliverability of paper tickets, opt your tickets into our LMS program.

(Money (object or null))

The purchase price paid by the seller for each ticket in the listing.

(Money (object or null))

The total purchase price paid by the seller.

sales_tax_paid
boolean or null

True if the seller already paid sales tax for the ticket(s); otherwise, false.

(SellerListingLinks (object or null))
(SellerListingEmbeddedResources (object or null))

Response samples

Content type
application/hal+json
{
  • "id": 0,
  • "created_at": "2019-08-24T14:15:22Z",
  • "number_of_tickets": 0,
  • "seating": {
    },
  • "display_seating": {
    },
  • "ticket_price": {
    },
  • "updated_at": "2019-08-24T14:15:22Z",
  • "external_id": "string",
  • "expires_at": "2019-08-24T14:15:22Z",
  • "display_number_of_tickets": 0,
  • "face_value": {
    },
  • "ticket_proceeds": {
    },
  • "in_hand_at": "2019-08-24T14:15:22Z",
  • "is_ticket_concierge": true,
  • "is_auto_po": true,
  • "barcodes": [
    ],
  • "instant_delivery": true,
  • "undeliverable": true,
  • "purchase_price_per_ticket": {
    },
  • "total_purchase_price": {
    },
  • "sales_tax_paid": true,
  • "_links": {
    },
  • "_embedded": {
    }
}

Update a seller listing by external ID

Update a seller listing by identifier that has been assigned to the listing in an external inventory management system.

Authorizations:
OAuth2
path Parameters
externalId
required
string or null
Request Body schema: application/json
One of
(Money (object or null))

The price of each ticket in the listing.

(Money (object or null))

The amount that the seller will receive for each ticket sold.

(SeatingRequest (object or null))

The seating information for the ticket(s) in this listing. For PATCH Requests, you need to pass in all the fields of a Seating to update, even when you only need to update some of the fields. Otherwise the rest of the fields will be set to empty.

(Money (object or null))

The price printed on the ticket, not including any booking fees.

ticket_type
string or null

The type of ticket(s) in this listing.

split_type
string or null

The way that the ticket(s) are allowed to be split up when sold.

number_of_tickets
integer or null <int32>

The number of tickets available for purchase.

display_number_of_tickets
integer or null <int32>

The number of tickets that should be displayed to buyers as available for purchase.

ticket_location_address_id
integer or null <int32>

The identifier of the address where the ticket(s) are located.

listing_note_ids
Array of integers or null <int32>

An array of listing note identifiers that provides additional notes on the listing

in_hand_at
string or null <date-time>

The date when the seller will have the tickets in hand.

external_id
string or null

An identifier that has been assigned to the listing in an external inventory management system.

notes
string or null

A comma-separated string of additional notes about the listing

instant_delivery
boolean or null
published
boolean or null

True when the listing should be published; Otherwise, false.

lms_optin
boolean or null

True when the listing should be opted into Last Minute Sales; Otherwise, false.

eticket_ids
Array of integers or null <int32>

A array of the identifiers of the E-Tickets to be assigned to the listing.

external_event_information
Array of objects or null (SellerListingExternalEventInformation)

Information about the listing's event on other platforms.

(Money (object or null))

The purchase price paid by the seller for each ticket in the listing.

(Money (object or null))

The total purchase price paid by the seller.

sales_tax_paid
boolean or null

True if the seller already paid sales tax for the ticket(s); otherwise, false.

barcodes
Array of objects or null (BarcodeInformation2)

Barcode(s) for the ticket(s) in this listing.

Responses

Response Schema: application/hal+json
id
integer or null <int64>

The listing identifier.

created_at
string or null <date-time>

The date when the listing was created.

number_of_tickets
integer or null <int32>

The number of tickets available for purchase.

(SeatingDetail (object or null))

The seating information for the ticket(s) in this listing.

(SeatingDetail (object or null))

The seating information that will be displayed to buyers for the ticket(s) in this listing.

(Money (object or null))

The price of each ticket in the listing.

updated_at
string or null <date-time>

The date when the listing was last updated.

external_id
string or null

An identifier that has been assigned to the listing in an external inventory management system.

expires_at
string or null <date-time>

The date when the listing will be automatically unpublished from the marketplace.

display_number_of_tickets
integer or null <int32>

The number of tickets that should be displayed to buyers as available for purchase.

(Money (object or null))

The price printed on the ticket, not including any booking fees.

(Money (object or null))

The amount that the seller will receive for each ticket sold.

in_hand_at
string or null <date-time>

The date when the seller will have the tickets in hand.

is_ticket_concierge
boolean

Whether the listing represents a shorted ticket

is_auto_po
boolean

Whether a listing was automatically generated from a purchase order

barcodes
Array of objects or null (BarcodeInformation)

Barcode(s) for the ticket(s) in this listing.

instant_delivery
boolean or null
undeliverable
boolean or null

Shipment of the ticket to the buyer cannot be guaranteed before the event. To increase the deliverability of electronic type tickets, preupload them (e.g. pre-upload barcodes or PDF files.) To increase deliverability of paper tickets, opt your tickets into our LMS program.

(Money (object or null))

The purchase price paid by the seller for each ticket in the listing.

(Money (object or null))

The total purchase price paid by the seller.

sales_tax_paid
boolean or null

True if the seller already paid sales tax for the ticket(s); otherwise, false.

(SellerListingLinks (object or null))
(SellerListingEmbeddedResources (object or null))

Request samples

Content type
application/json
{
  • "ticket_price": {
    },
  • "ticket_proceeds": {
    },
  • "seating": {
    },
  • "face_value": {
    },
  • "ticket_type": "string",
  • "split_type": "string",
  • "number_of_tickets": 0,
  • "display_number_of_tickets": 0,
  • "ticket_location_address_id": 0,
  • "listing_note_ids": [
    ],
  • "in_hand_at": "2019-08-24T14:15:22Z",
  • "external_id": "string",
  • "notes": "string",
  • "instant_delivery": true,
  • "published": true,
  • "lms_optin": true,
  • "eticket_ids": [
    ],
  • "external_event_information": [
    ],
  • "purchase_price_per_ticket": {
    },
  • "total_purchase_price": {
    },
  • "sales_tax_paid": true,
  • "barcodes": [
    ]
}

Response samples

Content type
application/hal+json
{
  • "id": 0,
  • "created_at": "2019-08-24T14:15:22Z",
  • "number_of_tickets": 0,
  • "seating": {
    },
  • "display_seating": {
    },
  • "ticket_price": {
    },
  • "updated_at": "2019-08-24T14:15:22Z",
  • "external_id": "string",
  • "expires_at": "2019-08-24T14:15:22Z",
  • "display_number_of_tickets": 0,
  • "face_value": {
    },
  • "ticket_proceeds": {
    },
  • "in_hand_at": "2019-08-24T14:15:22Z",
  • "is_ticket_concierge": true,
  • "is_auto_po": true,
  • "barcodes": [
    ],
  • "instant_delivery": true,
  • "undeliverable": true,
  • "purchase_price_per_ticket": {
    },
  • "total_purchase_price": {
    },
  • "sales_tax_paid": true,
  • "_links": {
    },
  • "_embedded": {
    }
}

Delete a seller listing by external ID

Delete a seller listing by identifier that has been assigned to the listing in an external inventory management system.

Authorizations:
OAuth2
path Parameters
externalId
required
string or null

Responses

Response samples

Content type
application/hal+json
{
  • "code": "string",
  • "message": "string",
  • "errors": {
    }
}

SellerListings (Preview)

Preview the changes you want to make to your inventory.

Preview a seller listing

Creates a preview of a seller listing. The listing will not have an id and will not actually be created on the StubHub marketplace.

Authorizations:
OAuth2
path Parameters
eventId
required
integer <int32>
Request Body schema: application/json
One of
(Money (object or null))

The price of each ticket in the listing.

(Money (object or null))

The amount that the seller will receive for each ticket sold.

required
(SeatingRequest (object or null))

The seating information for the ticket(s) in this listing. For PATCH Requests, you need to pass in all the fields of a Seating to update, even when you only need to update some of the fields. Otherwise the rest of the fields will be set to empty.

(Money (object or null))

The price printed on the ticket, not including any booking fees.

ticket_type
required
string or null

The type of ticket(s) in this listing.

split_type
required
string or null

The way that the ticket(s) are allowed to be split up when sold.

number_of_tickets
required
integer or null <int32>

The number of tickets available for purchase.

display_number_of_tickets
integer or null <int32>

The number of tickets that should be displayed to buyers as available for purchase.

ticket_location_address_id
integer or null <int32>

The identifier of the address where the ticket(s) are located.

listing_note_ids
Array of integers or null <int32>

An array of listing note identifiers that provides additional notes on the listing

in_hand_at
string or null <date-time>

The date when the seller will have the tickets in hand.

external_id
string or null

An identifier that has been assigned to the listing in an external inventory management system.

notes
string or null

A comma-separated string of additional notes about the listing

instant_delivery
boolean or null
published
boolean or null

True when the listing should be published; Otherwise, false.

lms_optin
boolean or null

True when the listing should be opted into Last Minute Sales; Otherwise, false.

eticket_ids
Array of integers or null <int32>

A array of the identifiers of the E-Tickets to be assigned to the listing.

external_event_information
Array of objects or null (SellerListingExternalEventInformation)

Information about the listing's event on other platforms.

(Money (object or null))

The purchase price paid by the seller for each ticket in the listing.

(Money (object or null))

The total purchase price paid by the seller.

sales_tax_paid
boolean or null

True if the seller already paid sales tax for the ticket(s); otherwise, false.

barcodes
Array of objects or null (BarcodeInformation2)

Barcode(s) for the ticket(s) in this listing.

Responses

Response Schema: application/hal+json
id
integer or null <int64>

The listing identifier.

created_at
string or null <date-time>

The date when the listing was created.

number_of_tickets
integer or null <int32>

The number of tickets available for purchase.

(SeatingDetail (object or null))

The seating information for the ticket(s) in this listing.

(SeatingDetail (object or null))

The seating information that will be displayed to buyers for the ticket(s) in this listing.

(Money (object or null))

The price of each ticket in the listing.

updated_at
string or null <date-time>

The date when the listing was last updated.

external_id
string or null

An identifier that has been assigned to the listing in an external inventory management system.

expires_at
string or null <date-time>

The date when the listing will be automatically unpublished from the marketplace.

display_number_of_tickets
integer or null <int32>

The number of tickets that should be displayed to buyers as available for purchase.

(Money (object or null))

The price printed on the ticket, not including any booking fees.

(Money (object or null))

The amount that the seller will receive for each ticket sold.

in_hand_at
string or null <date-time>

The date when the seller will have the tickets in hand.

is_ticket_concierge
boolean

Whether the listing represents a shorted ticket

is_auto_po
boolean

Whether a listing was automatically generated from a purchase order

barcodes
Array of objects or null (BarcodeInformation)

Barcode(s) for the ticket(s) in this listing.

instant_delivery
boolean or null
undeliverable
boolean or null

Shipment of the ticket to the buyer cannot be guaranteed before the event. To increase the deliverability of electronic type tickets, preupload them (e.g. pre-upload barcodes or PDF files.) To increase deliverability of paper tickets, opt your tickets into our LMS program.

(Money (object or null))

The purchase price paid by the seller for each ticket in the listing.

(Money (object or null))

The total purchase price paid by the seller.

sales_tax_paid
boolean or null

True if the seller already paid sales tax for the ticket(s); otherwise, false.

(SellerListingLinks (object or null))
(SellerListingEmbeddedResources (object or null))

Request samples

Content type
application/json
{
  • "ticket_price": {
    },
  • "ticket_proceeds": {
    },
  • "seating": {
    },
  • "face_value": {
    },
  • "ticket_type": "string",
  • "split_type": "string",
  • "number_of_tickets": 0,
  • "display_number_of_tickets": 0,
  • "ticket_location_address_id": 0,
  • "listing_note_ids": [
    ],
  • "in_hand_at": "2019-08-24T14:15:22Z",
  • "external_id": "string",
  • "notes": "string",
  • "instant_delivery": true,
  • "published": true,
  • "lms_optin": true,
  • "eticket_ids": [
    ],
  • "external_event_information": [
    ],
  • "purchase_price_per_ticket": {
    },
  • "total_purchase_price": {
    },
  • "sales_tax_paid": true,
  • "barcodes": [
    ]
}

Response samples

Content type
application/hal+json
{
  • "id": 0,
  • "created_at": "2019-08-24T14:15:22Z",
  • "number_of_tickets": 0,
  • "seating": {
    },
  • "display_seating": {
    },
  • "ticket_price": {
    },
  • "updated_at": "2019-08-24T14:15:22Z",
  • "external_id": "string",
  • "expires_at": "2019-08-24T14:15:22Z",
  • "display_number_of_tickets": 0,
  • "face_value": {
    },
  • "ticket_proceeds": {
    },
  • "in_hand_at": "2019-08-24T14:15:22Z",
  • "is_ticket_concierge": true,
  • "is_auto_po": true,
  • "barcodes": [
    ],
  • "instant_delivery": true,
  • "undeliverable": true,
  • "purchase_price_per_ticket": {
    },
  • "total_purchase_price": {
    },
  • "sales_tax_paid": true,
  • "_links": {
    },
  • "_embedded": {