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

Get a B2C order's status (and tickets once paid)

Public (no auth). Order status: pending | paid | expired | cancelled. Once paid (paid) it includes the issued ticket codes; the QR/ticket is delivered by email. While still pending it returns expiresAt, the instant (ISO 8601, UTC) at which its reservation expires — the SAME one returned by POST /orders, so a countdown can resume after a reload instead of restarting. It may be in the PAST: that means the reservation has already expired and there is no point sending the buyer to pay, even if the checkoutUrl still opens. A null expiresAt NEVER means ‘no time limit’: it means the order is no longer pending, or there is no reservation. The id is a non-enumerable cuid; no buyer data is exposed.

GET/orders/{id}
Path parameters
idstringrequired
Responses
200

OK

dataOrderStatusrequired
Show properties
orderIdstringrequired
referencestringrequired
statusstringrequired
Allowed:pendingpaidexpiredcancelled
totalnumberrequired
currencystringrequired
expiresAtstring | nullrequired
Show properties
Any of:
string
string
null
null
ticketsOrderTicket[]required
Show properties
Array of OrderTicket
ticketCodestringrequired
ticketTypeNamestringrequired
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
Parameters
Request
curl -X GET 'https://appfreeticket.com/api/public/orders/string'
Response
{
  "data": {
    "orderId": "string",
    "reference": "string",
    "status": "pending",
    "total": 0,
    "currency": "string",
    "expiresAt": "string",
    "tickets": [
      {
        "ticketCode": "string",
        "ticketTypeName": "string"
      }
    ]
  }
}