Skip to content
FreeTicketDocs
Esc
↑↓navigate↵open⌘Jpreview

Buyer's tickets

Requires the X-Customer-Session header. The enterprise service API key is OPTIONAL: with a key, results are additionally scoped to the workspace pinned to the key (its own events AND those where it is listed as a linked artist); without a key, returns ALL of the buyer’s tickets, not limited to any workspace. Only CONFIRMED sales, matched by the buyer’s account or purchase email.

GET/customer/tickets
Authorization
AuthorizationAPI key · headerrequired

API key prefixed with Bearer . Alternative: the x-api-key header with the raw key. Available scopes: read and write (see /.well-known/oauth-protected-resource).

or
x-api-keyAPI key · headerrequired

Raw API key (without Bearer ), alternative to Authorization.

Query parameters
limitinteger

1-100, default 20

default: 20
cursorstring
Header parameters
X-Workspace-Idstring

Active workspace to operate on. Optional: when omitted, the default workspace of the user who owns the key is used (pickActiveOrg).

Responses
200

OK

dataCustomerSale[]required
Show properties
Array of CustomerSale
idstringrequired
referencestringrequired
statusstringrequired
eventobjectrequired
Show properties
namestringrequired
slugstringrequired
eventDateobjectrequired
Show properties
startsAtstringrequired

Event start instant in ISO 8601 UTC.

timezonestringrequired

IANA time zone of the event.

itemsCustomerTicketItem[]required
Show properties
Array of CustomerTicketItem
ticketTypeNamestringrequired
quantityintegerrequired
min -9007199254740991 · max 9007199254740991
ticketCodestringrequired

Opaque ticket code. The QR code must encode the validator URL (https://admin.appfreeticket.com/dashboard/tickets/validar?code=<ticketCode>).

seatLabelstring | nullrequired

Exact seat for seated events (seats.io), or null.

Show properties
Any of:
string
string
null
null
totalnumberrequired
currencystringrequired
pagePagerequired
Show properties
nextCursorstring | nullrequired
Show properties
Any of:
string
string
null
null
hasMorebooleanrequired
totalinteger
min -9007199254740991 · max 9007199254740991
401

Missing or invalid credential.

errorobjectrequired
Show properties
codestringrequired
messagestringrequired
retryablebooleanrequired
detailsany
403

Insufficient role or resource not accessible.

errorobjectrequired
Show properties
codestringrequired
messagestringrequired
retryablebooleanrequired
detailsany
404

Resource does not exist or is out of scope.

errorobjectrequired
Show properties
codestringrequired
messagestringrequired
retryablebooleanrequired
detailsany
422

Request body/parameter validation failed.

errorobjectrequired
Show properties
codestringrequired
messagestringrequired
retryablebooleanrequired
detailsany
Try it
Server
Authorization
Parameters
Request
curl -X GET 'https://admin.appfreeticket.com/api/v1/customer/tickets' \
  -H 'Authorization: YOUR_API_KEY'
Response
{
  "data": [
    {
      "id": "string",
      "reference": "string",
      "status": "string",
      "event": {
        "name": "string",
        "slug": "string"
      },
      "eventDate": {
        "startsAt": "string",
        "timezone": "string"
      },
      "items": [
        {
          "ticketTypeName": "string",
          "quantity": -9007199254740991,
          "ticketCode": "string",
          "seatLabel": "string"
        }
      ],
      "total": 0,
      "currency": "string"
    }
  ],
  "page": {
    "nextCursor": "string",
    "hasMore": true,
    "total": -9007199254740991
  }
}