Tipos de entrada

Todo lo que se puede comprar en un evento, en una sola lista: entradas, combos y adicionales. Requiere el permiso EVENTS_READ.

GET /api/v1/events/{event_id}/ticket-types

curl "https://qrticket.app/api/v1/events/m94K1zLU8S/ticket-types" \
  -H "Authorization: Bearer qrt_live_..."

Parámetros

Parámetro	Tipo	Descripción
`include_deleted`	boolean	`true` para incluir los eliminados. Ver la nota más abajo.

Esta lista no se pagina: un evento tiene pocos tipos de entrada y te los devolvemos todos (has_more siempre es false).

Respuesta

{
  "data": [
    {
      "id": "TvEPjMm1rx",
      "kind": "ticket_type",
      "event_id": "m94K1zLU8S",
      "category": "ticket",
      "name": "PREVENTA",
      "description": null,
      "image_url": null,
      "price": 14000,
      "currency": "ARS",
      "status": "active",
      "deleted": false,
      "limit": 162,
      "sold": 146,
      "available": 16,
      "max_per_order": 4,
      "expires_at": null,
      "sales_start_at": null,
      "sales_end_at": "2026-10-01T02:59:00.000Z",
      "sales_start_after_id": null,
      "sales_end_status": "sold_out",
      "on_sale": true,
      "sort_order": 0,
      "includes": null
    },
    {
      "id": "b7KqmXz1",
      "kind": "bundle",
      "event_id": "m94K1zLU8S",
      "category": "bundle",
      "name": "COMBO PREVIA",
      "price": 25000,
      "currency": "ARS",
      "status": "active",
      "limit": 50,
      "sold": 12,
      "available": 38,
      "sales_start_at": null,
      "sales_end_at": null,
      "sales_start_after_id": null,
      "sales_end_status": "sold_out",
      "on_sale": true,
      "includes": [
        { "ticket_type_id": "TvEPjMm1rx", "event_id": "kd8Yq2Lp0a", "name": "PREVENTA", "category": "ticket", "quantity": 1 },
        { "ticket_type_id": "c9Lm2Qp",    "event_id": "kd8Yq2Lp0a", "name": "Fernet",   "category": "merchandise", "quantity": 2 }
      ]
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Campos

string

ticket_type para un ítem suelto, bundle para un combo. Es el campo por el que conviene ramificar.

string

ticket (entrada), merchandise (adicionales: estacionamiento, merchandising, guardarropa…) o bundle.

number

Precio en la moneda de currency, sin decimales implícitos: 14000 son catorce mil pesos, no ciento cuarenta. Un 0 es un ítem gratis (igual emite credencial).Este es el precio de lista. Lo que efectivamente pagó cada comprador está en los ítems de la orden, porque puede llevar cupón o recargo del procesador.

string

active, hidden, exclusive, sold_out o inactive.

active — visible y a la venta.
hidden — solo se compra con un link de acceso especial.
exclusive — reservado para el equipo (RRPP, cortesías).
sold_out — agotado.
inactive — apagado por el organizador.

boolean

Si alguien puede comprarlo ahora mismo desde la página pública. Combina status con la ventana de venta: un ítem active cuya tanda todavía no abrió, o cuya fecha de fin ya pasó, viene en false. Si vas a mostrar “disponible / no disponible”, este es el campo.

string | null

Inicio programado de la venta (ISO 8601), o null si vende desde que está activo.

string | null

Fin programado de la venta (ISO 8601), o null si vende hasta el evento. Después de este instante el ítem deja de venderse aunque siga active; sales_end_status dice cómo se muestra.

string | null

Tandas encadenadas: el id del tipo de entrada que tiene que terminar (agotarse, vencer o desactivarse) para que este empiece a venderse. null si no está encadenado. En un combo apunta siempre a otro combo (kind: "bundle").

string

Cómo se ve el ítem una vez que pasó sales_end_at: sold_out (sigue listado como agotado) o inactive (desaparece de la página). El status guardado no cambia — por eso conviene leer on_sale.

number

Credenciales vivas emitidas bajo este ítem. Excluye las eliminadas, las ocultas y las que se regalaron en una transferencia — es exactamente el número contra el que se controla el limit al vender, así que coincide con lo que ve el comprador.

number | null

limit - sold, o null cuando no hay límite (stock infinito).

array | null

Solo en los combos: qué trae adentro y cuántas unidades de cada cosa. null en los ítems sueltos.Un combo emite una credencial por unidad incluida. El combo del ejemplo genera 3 QRs por unidad vendida: una entrada y dos fernets.Cada ítem trae su event_id. En un combo de varias fechas (por ejemplo, Navidad + Año Nuevo) alguno es de otro evento de la productora: esa credencial se emite en ese evento, en una orden propia (ver combo_parent_order_id en Órdenes).

include_deleted. Eliminar un tipo de entrada no invalida las credenciales ya vendidas bajo él: la gente igual entra. Si estás reconciliando órdenes viejas y te aparece un ticket_type_id que no está en la lista, volvé a pedirla con include_deleted=true para resolver el nombre. Un tipo de entrada o combo sin ventas ni credenciales se borra definitivamente al eliminarlo, así que tampoco aparece con include_deleted=true.

Empezar

Referencia

Webhooks

Tipos de entrada

Tipos de entrada

Parámetros

Respuesta

Campos