Obtener Tickets Listados para un Evento

Este endpoint de la API permite recuperar una lista de tickets disponibles para un evento específico dentro del marketplace. Se realiza una solicitud HTTP GET a la siguiente URL, utilizando el ID único del evento para obtener información detallada sobre los tickets.

Ejemplo de Integración y Casos de Uso

Este endpoint permite la integración de información clave sobre los tickets disponibles en el mercado secundario dentro de su sistema. Por ejemplo, estos datos pueden utilizarse para mostrar tickets en un mapa de asientos, diferenciando entre los tickets del mercado primario y secundario. Además, los tickets pueden ser añadidos a un carrito de compras para iniciar la transacción de reventa directamente desde su plataforma.

Ejemplo de Solicitud

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

Atención

Recuerden reemplazar "YOUR_API_KEY" por su clave de API Privada

Parámetros de la Solicitud

• eventId (requerido): El ID único del evento para el cual se desean recuperar los tickets.
• showId (opcional): El ID del show específico dentro del evento (si el evento tiene múltiples funciones).

Respuesta JSON

{
  "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
  ]
}

Descripción de los Campos de la Respuesta

• totalCount: El número total de tickets disponibles para el evento.

• bestListing: Información del mejor ticket disponible.

  • ticketId: El identificador único del ticket. Por ejemplo, "414497".
  • price: El precio actual del ticket en el mercado secundario. En este caso, "4499.95".
  • currency: La moneda en la que se muestra el precio. En este caso, "ARS".
  • ticketOptionId: El identificador de la opción del ticket. Por ejemplo, "3994".
  • listingId: El identificador único del listado donde se ofrece el ticket. Ejemplo: "65f0ee7f4660c304303293c5".
  • seating: Información sobre el asiento.
    • section: Sección del asiento. Por ejemplo, "Popular Este".
    • row: Fila del asiento, como "23".
    • seat: Número o letra del asiento, como "C".

• results: Un array de las opciones de tickets disponibles.

  • ticketOptionId: Identificador de la opción del ticket. Por ejemplo, "3994".
  • count: Cantidad de tickets disponibles para esa opción. Ejemplo: "1".
  • bestListing: Información del mejor listado de ticket para esa opción.
    • ticketId: El identificador único del ticket.
    • price: El precio del ticket en esa opción.
    • currency: La moneda del ticket.
    • seating: Información sobre la sección, fila y número del asiento.
  • listings: Un array con todos los tickets listados.
    • ticketId: El identificador único del ticket.
    • price: El precio del ticket.
    • currency: La moneda del ticket.
    • seating: Detalles del asiento.
      • section: Sección del asiento. Por ejemplo, "Popular Este".
      • row: Fila del asiento. Ejemplo: "23".
      • seat: Número o letra del asiento. Ejemplo: "C".

Además, puede combinarse con otros endpoints de menta tech para agregar estos tickets a un carrito de compras y proceder con la reventa directamente desde su sistema.