List issued tickets

GET 
https://api.tickettailor.com/v1/issued_tickets

Returns all issued tickets

Request

Query Parameters

event_id string

The ID of the event to filter issued tickets for

event_series_id string

The ID of the event series to filter issued tickets for

order_id string

The ID of the order to filter issued tickets for

barcode string

The barcode of the issued ticket

name string

The name of the person attending an event

email string

The email of the person attending an event

reference string

The imported reference of the ticket

status string

Possible values: [valid, voided]

The status of the issued ticket

created_at integer

Unix timestamp filter that returns items with matched created_at value.

created_at.gt integer

Unix timestamp filter that returns items with created_at greater than given value.

created_at.gte integer

Unix timestamp filter that returns items with created_at greater than or equal given value.

created_at.lt integer

Unix timestamp filter that returns items with created_at less than given value.

created_at.lte integer

Unix timestamp filter that returns items with created_at less than or equal given value.

starting_after string

A paginator cursor value of object id (e.g. "or_123") that defines place in the list. To fetch next page of results, use the last object id from the current result list, e.g. starting_after=or_223.

ending_before string

A paginator cursor value of object id (e.g. "or_123") that defines place in the list. To fetch previous page of results, use the first object id from the current result list, e.g. ending_before=or_123.

limit string

The number of items to retrieve

Responses

200

A successfully returned issued ticket

application/json

Schema

Schema

data object[]
Array [
objectstringrequired
idstringrequired
A unique identifier for the issued ticket
add_on_idstringnullable
A unique identifier for the associated product
barcodestringrequired
Barcode text value
barcode_urlstringrequired
URL to barcode image
checked_instringrequired
Returns whether or not issued ticket is checked in
Possible values: [true, false]
created_atintegerrequired
Timestamp when issued ticket was created
custom_questions undefined[]required
Buyer provided answers to custom questions in checkout
Array [
questionstring
answerstringnullable
]
descriptionstringrequired
emailstringnullablerequired
The order email address
event_idstringrequired
ID of the event issued ticket belongs to
event_series_idstringrequired
ID of the event series the issued ticket belongs to
group_ticket_barcodestringnullablerequired
Barcode for group ticket, if it is part of one
referencestringnullablerequired
An external reference for imported tickets (via the API or Dashboard)
full_namestringnullablerequired
Full name of attendee
first_namestringnullablerequired
First name of attendee
last_namestringnullablerequired
Last name of attendee
reservationstringnullablerequired
Reservation from seating chart where applicable
statusstringrequired
Possible values: [valid, void]
sourcestringnullablerequired
Possible values: [api, dashboard_import]
ticket_type_idstringnullablerequired
ID of the ticket type
updated_atintegerrequired
Timestamp when issued ticket was last updated
voided_atintegernullablerequired
Timestamp when issued ticket was voided
order_idstringnullablerequired
A unique identifier for the order
qr_code_urlstringrequired
URL to QR code image
]
links object
nextstringnullable
previousstringnullable

Example (auto)

{
  "data": [
    {
      "object": "issued_ticket",
      "id": "it_50198",
      "add_on_id": null,
      "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": null,
      "first_name": null,
      "last_name": null,
      "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"
    }
  ],
  "links": {
    "next": "/v1/events/{event_id}/issued_tickets?starting_after=it_120",
    "previous": "/v1/events/{event_id}/issued_tickets?ending_before=it_100"
  }
}

default

Error schema

application/json

Schema

Schema

statusintegerrequired
Http status code
error_codestringrequired
Readable error code
messagestringrequired
Detailed error message
errors object[]
Validation errors if POST request was sent. Otherwise not present.
Array [
fieldstring
Field name that failed validation
messagesstring[]
Validation error message
]

Example (auto)

{
  "status": 0,
  "error_code": "string",
  "message": "string",
  "errors": [
    {
      "field": "string",
      "messages": [
        "string"
      ]
    }
  ]
}

Authorization: http

name: BasicAuthtype: httpdescription: Use base64 encoded api key created in Ticket Tailor dashboard.
scheme: basic

• curl
• php
• ruby
• python
• nodejs
• go

• CURL

curl -L 'https://api.tickettailor.com/v1/issued_tickets' \
-H 'Accept: application/json' \
-H 'Authorization: Basic PHVzZXJuYW1lPjo8cGFzc3dvcmQ+'

Request Collapse all

Base URL

https://api.tickettailor.com

Auth

Username

Password

Parameters

event_id — query

event_series_id — query

order_id — query

barcode — query

name — query

email — query

reference — query

status — query

---validvoided

created_at — query

created_at.gt — query

created_at.gte — query

created_at.lt — query

created_at.lte — query

starting_after — query

ending_before — query

limit — query