TItickettailor
Issued tickets

Create an issued ticket

Creates a new issued ticket for an event occurrence from the available inventory. Issuing tickets via the API is charged at one credit per issued ticket, even if the ticket is free. Send the event_id and ticket_type_id to create the issued ticket from an event occurrence's ticket type allocation. Alternatively, send the hold_id to create the issued ticket from a pre-existing hold. The issued ticket is not associated to an order. The request will fail if no tickets are available to fulfil the request, or the ticket type is a 'seated' type (uses a seating chart).

post/v1/issued_tickets

Request

Request body application/x-www-form-urlencoded

event_idstring

Event occurrence ID (required if creating from ticket type inventory)

ticket_type_idstring

Ticket type ID (required if creating from ticket type inventory)

hold_idstring

Hold ID to create the issued ticket from (required if creating from hold)

full_namestring required

The full name of the person attending the event

emailstring

The email of the person attending the event

send_emailboolean

When set to true, Ticket Tailor will attempt to send an email to the attendee with their ticket and event information. However, please note that setting send_email to true does not guarantee that an email will be successfully sent. The following conditions must be met for the email to be dispatched:

  1. A valid email must be provided in the request payload.
  2. The box office must be configured to use separate event confirmation emails and order confirmation emails.
  3. The event series to which the event belongs must be approved by Ticket Tailor staff.

<br/>If any of these conditions are not satisfied, the email will not be sent — even if send_email is set to true.

barcodestring

The barcode (ticket code) of the issued ticket (if empty, a barcode will be generated).

referencestring

An external reference for this issued ticket (e.g order number in external system)

Example request

{
  "event_id": "ev_1",
  "ticket_type_id": "tt_230656",
  "email": "john@example.com",
  "full_name": "John Doe"
}

Response

Successfully issued ticket

Example response

{
  "data": [
    {
      "object": "issued_ticket",
      "id": "it_50198",
      "add_on_id": "pr_123",
      "barcode": "al4R5",
      "barcode_url": "https://www.tickettailor.com/userfiles/cache/barcode/qr/attendee/50198/42bf63ef2a055b91a62f",
      "checked_in": "false",
      "created_at": 1587042697,
      "custom_questions": [],
      "description": "Free ticket",
      "email": "john@example.com",
      "event_id": "ev_40980",
      "event_series_id": "es_596",
      "group_ticket_barcode": null,
      "reference": "my reference code",
      "full_name": "John Doe",
      "first_name": "John",
      "last_name": "Doe",
      "listed_currency": {
        "base_multiplier": 100,
        "code": "gbp"
      },
      "listed_price": 100,
      "status": "valid",
      "source": "api",
      "ticket_type_id": "tt_230656",
      "updated_at": 1587042697,
      "voided_at": null,
      "order_id": "or_737352",
      "qr_code_url": "https://www.tickettailor.com/userfiles/cache/barcode/st/attendee/50198/42bf63ef2a055b91a62f"
    }
  ]
}

Changes

No recorded changes to this operation across all 6 revisions of this API.