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

The purchase the buyer left unfinished for this event date

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 it; without a key, any of the buyer’s own unfinished purchases is visible. Returns the PENDING sale whose inventory hold is STILL ALIVE that the buyer has for that event date —with its seats, its total and when it expires—, or order: null if there is none. This is what lets reloading the checkout, or coming back from signing in, RESUME the purchase instead of starting from scratch: the seats remain held in that person’s name. If paymentOpened is true the payment is already open and POST /customer/orders/{id}/payment returns the SAME signed configuration; to discard it and pick other seats, use POST /customer/orders/{id}/release.

GET/customer/orders
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
eventDateIdstring

Required. The event date being queried.

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

dataCustomerOrderCurrentrequired
Show properties
orderobject | nullrequired

The purchase the buyer left unfinished for this event date, or null if there is none.

Show properties
Any of:
object
saleIdstringrequired
referencestringrequired
totalnumberrequired
currencystringrequired
expiresAtstringrequired

Instant (ISO 8601 UTC) at which the inventory hold expires. This is the countdown to display.

paymentOpenedbooleanrequired

true = payment has already been opened for this sale. Reopening it with /payment returns the SAME signed configuration while the reservation is still alive.

itemsobject[]required
Show properties
Array of object
ticketTypeIdstringrequired
ticketTypeNamestringrequired
quantityintegerrequired
min -9007199254740991 · max 9007199254740991
seatLabelstring | nullrequired

seats.io numbered seat, or null if not seated.

Show properties
Any of:
string
string
null
null
null
null
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

Operation error.

errorobjectrequired
Show properties
codestringrequired
messagestringrequired
retryablebooleanrequired
detailsany
Try it
Server
Authorization
Parameters
Request
curl -X GET 'https://admin.appfreeticket.com/api/v1/customer/orders' \
  -H 'Authorization: YOUR_API_KEY'
Response
{
  "data": {
    "order": {
      "saleId": "string",
      "reference": "string",
      "total": 0,
      "currency": "string",
      "expiresAt": "string",
      "paymentOpened": true,
      "items": [
        {
          "ticketTypeId": "string",
          "ticketTypeName": "string",
          "quantity": -9007199254740991,
          "seatLabel": "string"
        }
      ]
    }
  }
}