Skip to main content

Get Listed Tickets for an Event

This API endpoint allows you to retrieve a list of available tickets for a specific event within the marketplace. An HTTP GET request is made to the following URL, using the unique event ID to obtain detailed information about the tickets.

Integration Example and Use Cases​

This endpoint allows the integration of key information about available tickets in the secondary market into your system. For example, this data can be used to display tickets on a seat map, differentiating between primary and secondary market tickets. Additionally, tickets can be added to a shopping cart to initiate the resale transaction directly from your platform.

Request Example​

curl --location --request GET 'https://api.mentatech.io/v1/marketplace/items/events/abc123/listedTickets?showId=xyz789' \
--header 'Authorization:  "YOUR_API_KEY"
Attention

Remember to replace "YOUR_API_KEY" with your Private API key.

Request Parameters​

  • eventId (required): The unique event ID for which you want to retrieve tickets.
  • showId (optional): The ID of the specific show within the event (if the event has multiple shows).
JSON Response
{
    "status": 200,
    "data": {
        "totalCount": 2,
        "bestListing": {
            "ticketId": "414497",
            "price": 4499.95,
            "currency": "ARS",
            "ticketOptionId": "3994",
            "listingId": "65f0ee7f4660c304303293c5",
            "seating": {
                "section": "Popular Este",
                "row": 23,
                "seat": "C"
            }
        },
        "results": [
            {
                "ticketOptionId": "3994",
                "count": 1,
                "bestListing": {
                    "ticketId": "414497",
                    "price": 4499.95,
                    "currency": "ARS",
                    "ticketOptionId": "3994",
                    "listingId": "65f0ee7f4660c304303293c5",
                    "seating": {
                        "section": "Popular Este",
                        "row": 23,
                        "seat": "C"
                    }
                },
                "listings": [
                    {
                        "ticketId": "414497",
                        "price": 4499.95,
                        "currency": "ARS",
                        "ticketOptionId": "3994",
                        "listingId": "65f0ee7f4660c304303293c5",
                        "seating": {
                            "section": "Popular Este",
                            "row": 23,
                            "seat": "C"
                        }
                    }
                ]
            },
            {
                "ticketOptionId": "3995",
                "count": 1,
                "bestListing": {
                    "ticketId": "414949",
                    "price": 4600,
                    "currency": "ARS",
                    "ticketOptionId": "3995",
                    "listingId": "65efa0ba382e69cb75fafaaa",
                    "seating": {
                        "section": "Popular Norte",
                        "row": 4,
                        "seat": "J"
                    }
                },
                "listings": [
                    {
                        "ticketId": "414949",
                        "price": 4600,
                        "currency": "ARS",
                        "ticketOptionId": "3995",
                        "listingId": "65efa0ba382e69cb75fafaaa",
                        "seating": {
                            "section": "Popular Norte",
                            "row": 4,
                            "seat": "J"
                        }
                    }
                ]
            }
        ]
    },
    "errors": [
        null
    ]
}

Response Field Descriptions​

  • totalCount: The total number of tickets available for the event.

  • bestListing: Information about the best available ticket.

    • ticketId: The unique identifier of the ticket. For example, "414497".
    • price: The current price of the ticket in the secondary market. In this case, "4499.95".
    • currency: The currency in which the price is displayed. In this case, "ARS".
    • ticketOptionId: The identifier of the ticket option. For example, "3994".
    • listingId: The unique identifier of the listing where the ticket is offered. Example: "65f0ee7f4660c304303293c5".
    • seating: Information about the seat.
      • section: The seat section. For example, "Popular Este".
      • row: The seat row, such as "23".
      • seat: The seat number or letter, such as "C".

  • results: An array of available ticket options.

    • ticketOptionId: Identifier of the ticket option. For example, "3994".
    • count: Number of tickets available for that option. Example: "1".
    • bestListing: Information about the best ticket listing for that option.
      • ticketId: The unique identifier of the ticket.
      • price: The price of the ticket for that option.
      • currency: The currency of the ticket.
      • seating: Information about the section, row, and seat number.
    • listings: An array with all listed tickets.
      • ticketId: The unique identifier of the ticket.
      • price: The ticket's price.
      • currency: The ticket's currency.
      • seating: Details of the seat.
        • section: The seat section. For example, "Popular Este".
        • row: The seat row. Example: "23".
        • seat: The seat number or letter. Example: "C".

Additionally, this can be combined with other menta tech endpoints to add these tickets to a shopping cart and proceed with the resale directly from your system.