Resale Fan Session
Overview
Fan session ensures the price shown on the resale listing matches the price shown in checkout.
Top Picks API Resale Information
Top Picks API now returns a FanSession. FanSession contains information about partner’s session that contains session id, session start and expire time.
Note : This feature is applicable for all partners who are allowed to transact on Resale Inventory
Once a fan session is created the partner can use the header X-TM-SESSION-SID to maintain the price during the transaction process.
- If the header is NOT specified, then a new FanSession will be created and return to them.
- If the header is specified and it has NOT expired, then we will return the FanSession associated with the X-TM-SESSION-SID.
- If the header is specified and it has expired, then a new FanSession will be created with that ID and return to them along with this message: SESSION_HAS_EXPIRED_PRICE_MIGHT_HAVE_CHANGED
Top Picks Response structure with Fan Session, Listing Details, and Listing Notes:
fanSession(object) - Fansession Object.resaleSid(object) - Resale SessionId Object.sessionId(string) - Session IDsessionStartTime(string) - Start time of valid sessionsessionExpireTime(string) - Expiry time of session id
page(object) - Page information.number(number) - current page number counted from 1.size(number) - size of current page (max=30 per page).totalElements(number) - total number of elements available.totalPages(number) - total number of pages available.
picks(array) - Picks.{array item object}- pick.type(string) - “general-seating”, or “seats”quality(number) - A quality score representing a combination of price and location to stage.area(object) - An area informationid(string) - Area idname(string) - Area namedescription(string) - Area description
descriptions(array) - A list of descriptions for this picksection(string) - The section name in the venueselection(string) - “standard”, or “resale”.row(string) - The row in the section, if applicable (not available during onsale).snapshotImageUrl- An image url of this pick in the venue. If the venue or event doesn’t support detailed images, this field will be null.listing_details(string) - For Resale inventory, a description of seat location is surfaced here to convey to the fan the Section, Row and Seat information, when available. Ticket estimated delivery date is surfaced for 3rd Party Resale events.offers(array) - Offers.{array item object}- offer.offer id(string) - The offer id corresponding to one in _embedded.offer[].
seats(array) - Seats (not available during onsale).{array item object}- seat.seat id(string) - seat names.
_embedded(object) - container for events.offer(array) - Offers matching those found in picks[] items.{array item object}- offer.offerId(string) - The offer id.name(string) - Name of the offer.ticketTypeId(string) - Ticket type id required for reserves.priceLevelId(string) - Price level id (optional for reserves).description(string) - Description of the offer.currency(string) - ISO 4217 currency code.faceValue(number) - Face value of one ticket.totalPrice(number) - Total price including charges (may not include order processing fees).charges(array) - Charges.{array item object}- charge.reason(string) - Name of charge.type(string) - Type of charge.amount(number) - Amount of chargefee_type(string) - Type of fee (e.g. PER TICKET)
limit(object) - ticket limits infomin(number) - Min no of ticketsmax(number) - Max no of tickets
promotions(array) - promotions.listingNotes(object) - Details about the resale ticket deliverydeliveryDate(string) - Delivery DatedeliveryMethod(string) - Method of deliverydeliveryDescription(string) - Details of ticket deliverysellerNotes(string) - Notes added by the original seller
eventDetails(object)- Event detailsid(string) - Id of the eventgranularPricing(boolean) - True/False based on if the event is granular pricingvenueMapUrl(string) - Url for venue mapvenueMapWithLabelsUrl(string) - Url for venue map with labelssafeTixEnabled(boolean) - True/False based on if the event is safetix enabled/enforcedallInclusivePricing(boolean) - True/False based on if the event is using all-in pricinglistingsDisclaimer(string) - Copy in this field is used to communicate important information to a fan; includes some legal disclaimers (eg US or UK all in pricing) and should be leveraged in a partner’s UItransfer(object) - Transfer Eligibilityeligible(boolean) - True/False based on if tickets to the event are transferableexplanation(string) - Explanation of transfer eligibility status
agreements(array) - Items{arrayitemobject}- itemname(text) - name Eg. “MLB_PRIVACY_POLICY”locale(text) - localetext(number) - text to display the opt in Eg. “MLB Privacy Policy”type(string) - Eg. “acknowledgement”agreement_url(string) - link to the agreement Eg. “https://mlb.com/privacy-policy”
https://app.ticketmaster.com/top-picks/v1/events/id/Z7r9rdtsuO8g?&apikey=orscdg*****************KUcGnl&quantity=2&selection=Resale&sort=qualityStatus 200
{
"fanSession": {
"resaleSid": {
"sessionId": "d893cbac-04df-4473-ba14-9a588a9521eb",
"sessionStartTime": 1746557854994,
"sessionExpireTime": 1746561454994
}
},
"page": {
"number": 1,
"size": 30,
"totalElements": 340,
"totalPages": 12
},
"picks": [
{
"type": "seats",
"quality": 1,
"section": "336",
"selection": "resale",
"row": "14",
"snapshotImageUrl": "https://app.ticketmaster.com/maps/geometry/3/event/Z7r9rdtsuO8g/image?systemId=HOST&app=TOPPICKS§ionNames=336",
"listingDetails": "You'll get 2 tickets together in Sec 336, Row 14, Seats 11-12. Tickets will be available by Fri, Jul 11, 2025.",
"area": {},
"offers": [
"HB6DQOBUGQZTSNBWGZ6DCMRSG5SGIYJVMY2Q"
]
},
{
"type": "seats",
"quality": 1,
"section": "332",
"selection": "resale",
"row": "16",
"snapshotImageUrl": "https://app.ticketmaster.com/maps/geometry/3/event/Z7r9rdtsuO8g/image?systemId=HOST&app=TOPPICKS§ionNames=332",
"listingDetails": "You'll get 2 tickets together in Sec 332, Row 16, Seats 9-12. Tickets will be available by Fri, Jul 11, 2025.",
"area": {},
"offers": [
"HB6DQNRYG42DKNJWGR6DCMRSMY2TANJVGQ2Q"
]
},
{
"type": "seats",
"quality": 1,
"section": "330",
"selection": "resale",
"row": "18",
"snapshotImageUrl": "https://app.ticketmaster.com/maps/geometry/3/event/Z7r9rdtsuO8g/image?systemId=HOST&app=TOPPICKS§ionNames=330",
"listingDetails": "You'll get 2 tickets together in Sec 330, Row 18, Seats 13-16. Tickets will be available by Fri, Apr 25, 2025.",
"area": {},
"offers": [
"HB6DQNRWGAZTAOJRGR6DCMRTGE2TGOLFGY2Q"
]
}
],
"_embedded": {
"offer": [
{
"offerId": "HB6DQOBUGQZTSNBWGZ6DCMRSG5SGIYJVMY2Q",
"name": "Resale Ticket",
"ticketTypeId": "resale-listingVer-0000001227dda5f5:product-product-0000000003a7b339:product-variant-0000000e986a8805:Z7r9rdtsuO8g",
"description": "Resale Ticket",
"currency": "USD",
"faceValue": 16,
"totalPrice": 20,
"charges": [
{
"reason": "service",
"type": "fee",
"amount": 4,
"fee_type": "PER TICKET"
},
{
"reason": "order_processing",
"type": "fee",
"amount": 3.95,
"fee_type": "PER ORDER"
}
],
"limit": {
"min": 2,
"max": 2
},
"promotions": [],
"protected": false,
"listingNotes": {
"deliveryDate": "Tickets Available by Fri, Jul 11, 2025",
"deliveryMethod": "Mobile Entry",
"deliveryDescription": "These mobile tickets will be transferred directly to you from a trusted seller. We'll email you instructions on how to accept them on the original ticket provider's mobile app.",
"sellerNotes": "XFER"
}
},
{
"offerId": "HB6DQNRYG42DKNJWGR6DCMRSMY2TANJVGQ2Q",
"name": "Resale Ticket",
"ticketTypeId": "resale-listingVer-000000122f505545:product-product-0000000003a7b339:product-variant-0000000e5615ef55:Z7r9rdtsuO8g",
"description": "Resale Ticket",
"currency": "USD",
"faceValue": 16,
"totalPrice": 20,
"charges": [
{
"reason": "service",
"type": "fee",
"amount": 4,
"fee_type": "PER TICKET"
},
{
"reason": "order_processing",
"type": "fee",
"amount": 3.95,
"fee_type": "PER ORDER"
}
],
"limit": {
"min": 2,
"max": 4
},
"promotions": [],
"protected": false,
"listingNotes": {
"deliveryDate": "Tickets Available by Fri, Jul 11, 2025",
"deliveryMethod": "Mobile Entry",
"deliveryDescription": "These mobile tickets will be transferred directly to you from a trusted seller. We'll email you instructions on how to accept them on the original ticket provider's mobile app.",
"sellerNotes": "XFER"
}
},
{
"offerId": "HB6DQNJRGM2TOOJXGJ6DCMRRGM3TKNBWGY2Q",
"name": "Resale Ticket",
"ticketTypeId": "resale-listingVer-0000001213754665:product-product-0000000003a7b339:product-variant-0000000e0ae30f95:Z7r9rdtsuO8g",
"description": "Resale Ticket",
"currency": "USD",
"faceValue": 23,
"totalPrice": 28.75,
"charges": [
{
"reason": "service",
"type": "fee",
"amount": 5.75,
"fee_type": "PER TICKET"
},
{
"reason": "order_processing",
"type": "fee",
"amount": 3.95,
"fee_type": "PER ORDER"
}
],
"limit": {
"min": 1,
"max": 7
},
"promotions": [],
"protected": false,
"listingNotes": {
"deliveryDate": "Tickets Available by Fri, Apr 25, 2025",
"deliveryMethod": "Mobile Entry",
"deliveryDescription": "These mobile tickets will be transferred directly to you from a trusted seller. We'll email you instructions on how to accept them on the original ticket provider's mobile app.",
"sellerNotes": ""
}
}
]
},
"eventDetails": {
"agreements": [
{
"name": "MLB_OPTIN",
"text": "I would like to receive commercial emails from MLB, the Baltimore Orioles, and their partners.",
"type": "boolean",
"locale": "en-us"
},
{
"name": "MLB_OPTIN",
"text": "I would like to receive commercial emails from MLB, the Baltimore Orioles, and their partners.",
"type": "boolean",
"locale": "en-ca"
},
{
"name": "MLB_PRIVACY_POLICY",
"text": "MLB Privacy Policy",
"type": "acknowledgement",
"locale": "en-us",
"agreement_url": "https://mlb.com/privacy-policy"
}
],
"id": "Z7r9jZ1A7uO8g",
"granularPricing": false,
"venueMapUrl": "https://app.ticketmaster.com/maps/geometry/3/event/Z7r9rdtsuO8g/image?app=TOPPICKS",
"venueMapWithLabelsUrl": "https://app.ticketmaster.com/maps/geometry/3/event/Z7r9rdtsuO8g/image?app=TOPPICKS&showLabels=true",
"allInclusivePricing": true,
"listingsDisclaimer": "Price includes fees (before taxes if applicable). An order processing fee of up to $3.95 may be added to each order."
}
}Partner API Resale Reserve
To reserves RESALE tickets, partner needs to send session id from FanSession information that they get from TOPPICKS to PARTNERAPI. The session ID should be sent via header in X-TM-SESSION-SID. This will ensure the price stability.
curl --location 'https://app.ticketmaster.com/partners/v1/events/Z7r9rdtsuO8g/cart?apikey=orscdg*****************KUcGnl' \
--header 'X-TM-SESSION-SID: d893cbac-04df-4473-ba14-9a588a9521eb' \
--header 'Content-Type: application/json' \
--data '{
"reserve" : {
"tickets" : [ {
"quantity" : 2,
"id" : "resale-listingVer-0000001227dda5f5:product-product-0000000003a7b339:product-variant-0000000e986a8805"
} ]
}
}'Status 200
{
"cart_id": "502707c8-12a4-4d2e-8dad-4eccd8feecf2",
"cart": {
"items": [
{
"type": "ticket",
"id": 1,
"tickets": [
{
"id": "resale-listingVer-0000001227dda5f5:product-product-0000000003a7b339",
"quantity": 2,
"inventory_type": "RESALE",
"listing_details": "You'll get 2 tickets together in Sec 336, Row 14, Seats 11-12. Tickets will be available by Fri, Jul 11, 2025.",
"charges": [
{
"price": 16.00,
"type": "face_value",
"quantity": 2,
"tax": 0
},
{
"price": 4.00,
"type": "service",
"quantity": 2,
"tax": 0
},
{
"price": 0,
"type": "tax",
"quantity": 0,
"tax": 0
}
],
"averageOriginalTotalValue": "9999.00"
}
],
"ga": false,
"totals": {
"currency_code": "USD",
"fee": 8.00,
"grand": 40.00,
"merchandise": 32.00,
"tax": 0.00
},
"event_id": "Z7r9rdtsuO8g",
"num_seats": 2,
"row": "14",
"section": "336",
"start_seat_number": "11",
"end_seat_number": "12",
"is_ga": false,
"quantity": 2,
"inHandDate": "2025-07-10T05:00:00.000Z"
}
],
"totals": {
"currency_code": "USD",
"delivery": 0.00,
"fee": 8.00,
"grand": 44.00,
"merchandise": 32.00,
"tax": 4.00,
"unpaid": 44.00,
"upsell": 0.00
},
"language": "en-us",
"hold_time": 0,
"agreements": [
{
"name": "MLB_OPTIN",
"locale": "en-us",
"text": "I would like to receive commercial emails from MLB, the Baltimore Orioles, and their partners.",
"type": "boolean"
},
{
"name": "MLB_OPTIN",
"locale": "en-ca",
"text": "I would like to receive commercial emails from MLB, the Baltimore Orioles, and their partners.",
"type": "boolean"
},
{
"name": "MLB_PRIVACY_POLICY",
"locale": "en-us",
"text": "MLB Privacy Policy",
"type": "acknowledgement",
"agreement_url": "https://mlb.com/privacy-policy"
}
]
},
"fan_session": {
"resaleSid": {
"sessionId": "d893cbac-04df-4473-ba14-9a588a9521eb",
"sessionStartTime": 1746557854994,
"sessionExpireTime": 1746561454994
}
}
}Resale Seat Disclosure
- In order to provide fans with clear and accurate information about ticket listings when the inventory is Ticketmaster Verified Resale or 3rd Party Resale, we have additional language in the API regarding seat location.
- This can be leveraged by partners to provide the same level of seat information that we provide on Ticketmaster.com.
- Partners should utilize this copy in order to provide the fan with accurate seat information and to comply with legal mandates in select states - it is currently required to disclose seat location prior to purchase in Maryland, Minnesota, Nevada.
- The copy for seat information can be found in our Top Picks API under the field picks.listingsDetails and in the Cart Response in tickets.listings_details
- For 3rd Party Resale inventory, we also include the estimated delivery date of the tickets from the original ticketer.
3rd Party Resale & Seller Notes
3rd Party Resale Events are resale tickets by trusted sellers outside of Ticketmaster.com that can also be purchased via our Top Picks API for Open Inventory partners using the Partner API. Please reach out to partnersupport@ticketmaster.com if you are interested in enabling 3rd Party Resale inventory.
Note that when searching for eligible 3rd Party Resale inventory events to transact on, this inventory source can be queried in our Discovery Feed using source=TMR and transactable=TRUE.
Additional Considerations for 3rd Party Resale:
- Listing & Seller Notes: Because the tickets are being sold via another seller outside of Ticketmaster.com and will be fulfilled by this resale partner, partners should surface any notes from this Seller to the partner in their experience using the Top Picks field “sellerNotes”. See Top Picks Response Structure and Sample Response.
- The listingDetails field contains information about the seats being offered and the date by which the tickets will be available after purchase.
- Additional details to be surfaced for the fan is available under the listing notes object. The delivery type, description about delivery and the seller notes.
For Example:
- Claim Flow: Once a 3rd Party Resale purchase is complete via our APIs, the fan will receive an email confirmation via our Claim Flow. There will be specific ticket delivery instructions and order status indicators in the email. There will be slightly different emails for 3rd Party Resale than Ticketmaster inventory. The flow will also vary based on if the third party seller is delivering the ticket via Mobile App or PDF. The emails will instruct the user appropriately.
