Tickets
A ticket is one admission to an event. Flint creates a ticket for each ticket a buyer purchases from an event payment link, at the same moment it issues the ticket numbers. Each ticket has its own ticket_id with the tkt_ prefix, so you can read it without knowing its order.
A ticket starts issued. Checking it in makes it checked_in, and undoing the check-in returns it to issued. Voiding it, or a full refund of its order, makes it voided, which is final. supported_actions lists what the ticket accepts now:
status | supported_actions |
|---|---|
issued | check_in, void |
checked_in | undo_check_in, void |
voided | none |
To sell tickets on your own page instead of Flint's hosted checkout, replace the resolved hosted session with a headless one, as Sell event tickets on your own page describes. The buyer's checkout credential then lists the order's tickets with their admission codes.
Reading tickets needs commerce.tickets.read, and changing them needs commerce.tickets.write. Neither scope includes access to orders or refunds, so a key for door staff can't issue a refund. expand=order also requires commerce.orders.read. Partner apps can read tickets but can't change them.
Check in#
POST /v1/tickets/{ticket_id}/check-in admits an issued ticket. Send the scanned admission_code to confirm the code belongs to this ticket, and Flint records check_in_method: admission_code. Send no code to admit the ticket by hand, recorded as manual. Check-in has no time window.
Flint admits each ticket once. When two scanners check in the same ticket at the same time, one succeeds and the other gets 409 ACTION_NOT_ALLOWED with reason already_applied and current_status: checked_in. A voided ticket returns reason unsupported_state with current_status: voided. Scanners usually omit expected_version: a stale one returns 409 VERSION_CONFLICT instead of telling the door the ticket is already in.
A code that isn't 16 valid characters, or isn't this ticket's current code, returns 400 INVALID_REQUEST with detail code INVALID_VALUE and param set to admission_code, and the ticket doesn't change. To check in from a scan without the ticket ID, look the code up first with POST /v1/tickets/lookup, then check in that ticket with the same code.
curl -X POST https://api.withflintpay.com/v1/tickets/tkt_01K4GALA/check-in \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"admission_code": "8F3K-2M9Q-7XRD-4HTV"}'
POST /v1/tickets/{ticket_id}/undo-check-in returns a checked-in ticket to issued and clears checked_in_at and check_in_method. On an issued ticket it returns already_applied, and on a voided ticket unsupported_state.
Void a ticket#
POST /v1/tickets/{ticket_id}/void permanently voids an issued or checked_in ticket and frees its seat. In the same change, the event link's total_quantity_sold drops by one. As with a refund, the link's version doesn't change. Voiding refunds nothing and doesn't change the order's ticketed_event, so refund the order yourself if the buyer should get money back. A later full refund of the order voids only its remaining valid tickets and frees only their seats. Voiding a voided ticket returns already_applied.
Attendee names#
PATCH /v1/tickets/{ticket_id} sets attendee_name. Flint trims surrounding spaces, and the name must then be 1 to 200 characters. Send null to clear it. Sending the current name changes nothing and keeps the version. A voided ticket returns 409 ACTION_NOT_ALLOWED with reason unsupported_state.
Admission codes#
An admission code is a secret that identifies one ticket. Merchant reads, lists, and webhooks never include it, and admission_code_last4 shows only its last four characters. Only the ticket's buyer gets the full code, and only where they proved themselves. The paid checkout session's own paying credential reads it on its order's tickets; a checkout link you read from the checkout session, or request after payment, doesn't. GET /v1/me/tickets returns it to a buyer whose email Flint verified, by signing in to Flint's hosted account or through the paid checkout, on orders whose buyer_email is that email. Ticket and receipt emails sent to the order's buyer_email, with no one copied, show each valid ticket's code with a QR code that holds it. Access links, customer sessions and checkout links you create never carry codes, and a receipt you send to another address lists the ticket numbers without them. To deliver tickets from your own pages, issue a code with rotate-code. Flint doesn't log the code, and it stays out of URLs and filters, so look a ticket up by sending the code in the body of POST /v1/tickets/lookup.
Lookup and check-in accept the code in lowercase, with spaces or hyphens, and read O as 0 and I or L as 1. Lookup returns the ticket whatever its status. A code that isn't 16 valid characters returns 400 INVALID_REQUEST with detail code INVALID_VALUE, and a code that matches no ticket in the key's environment returns 404 RESOURCE_NOT_FOUND, both with param set to admission_code. Branch on error.code; details[0].code names the cause. A code from another merchant, or from the other environment, is not found.
POST /v1/tickets/{ticket_id}/rotate-code replaces a ticket's code and returns the ticket with the new code in admission_code, formatted XXXX-XXXX-XXXX-XXXX. The old code stops working immediately. This is the only merchant route that returns a code. To deliver tickets yourself, turn off send_ticket_emails on the event link, rotate each ticket's code, and encode the code in your QR code without hyphens.
A retry with the same Idempotency-Key returns the code again under the one-time secret rules, as long as the ticket hasn't changed since the rotation. After any later change to the ticket, including another rotation, the retry returns the ticket without admission_code. A voided ticket returns 409 ACTION_NOT_ALLOWED with reason unsupported_state.
Versions#
Every change accepts an optional expected_version. When it doesn't match the ticket's current version, the request returns 409 VERSION_CONFLICT and changes nothing, even when the ticket's status would also refuse the action. Read the ticket again before you retry.
Events#
Every ticket event carries the ticket as a read returns it, without the code.
ticket.created: Flint issued the ticket.ticket.checked_in: the ticket was checked in.ticket.voided: you voided the ticket, or a full refund voided it.ticket.updated: any other change, such as an attendee name edit, an undone check-in, or a replaced code. A replaced code changesadmission_code_last4andversion.
See Read individual tickets for the fields and a list example.
The Ticket object#
An individual admission, a top-level child of an order. Merchant reads and webhooks never include the bearer admission code.
Returned by GET /v1/tickets/{ticket_id} and carried by the endpoints below.
Attributes
admission_codestringThe ticket's 16-character Crockford base32 admission code, the value its QR code holds. A bearer secret: only the paid checkout session's own paying credential receives it, on its own order's tickets that aren't voided. A checkout credential from a launch URL a merchant reads or requests after payment never does. Returned only to the checkout credential; never in webhook payloads.
Not returned with a bearer token
admission_code_last4stringRequiredLast four characters of the current admission code.
attendee_namestring or nullRequiredOptional attendee name. Null when not supplied.
check_in_methodenum or nullRequiredHow the ticket was admitted. Null when the ticket is not checked in.
admission_codemanual
checked_in_atstring or nullRequiredWhen the ticket was admitted. Null when the ticket is not checked in.
created_atstringRequiredWhen the ticket was issued.
orderobjectOrder summary, present only with expand=order. Requires commerce.orders.read.
buyer_contactobjectBuyer contact recorded on the order, including guest contact when retained. Omitted when the order has no recorded contact.
Not returned with a checkout credential or a customer session
closed_atstringWhen the order closed. Present exactly when status is closed. Set once at the transition and never changed.
closed_reasonenumWhy the order closed. Present exactly when status is closed. Set once at closure. Unrecognized reasons are returned as other; new values may be added.
invoice_voidedpaidclosed_by_merchantcheckout_expiredwritten_offsupersededreturn_resolution_canceledother
created_atstringWhen the order was created, in RFC3339 format.
customer_idstringCustomer associated with the order, when one is set.
deferred_promotionsarray of objectRequiredPromotions accepted at subscription signup. They attach when the subscription is provisioned and first discount its first charged cycle. They do not discount this order and are separate from discounts and order totals. Always present; empty when no promotions are deferred.
fulfillment_statusenumAggregate progress across the order's fulfillment quantities.
not_fulfilledpartially_fulfilledfulfilledcancelednot_applicableclosed
governing_delivery_selection_idstring or nullRequiredID of the delivery selection that governs this order. Null when no selection governs the order.
order_idstringRequiredStable identifier of the expanded order.
order_numberstringHuman-readable order number for receipts and merchant reference.
paid_atstring or nullRequiredWhen `payment_status` became `paid`, including a final capture that releases the remaining balance. Set once and never changed, including after refunds. `null` when `payment_status` isn't `paid`, including an order whose balance was written off without being paid.
payment_intent_idsarray of stringPayment intents associated with the order.
payment_statusenumRequiredCollection progress. An invoice write-off also completes collection without receiving the written-off amount.
unpaidpartially_paidpaid
pricing_amountsobjectRequiredOrder totals before accounting for collected payments and refunds.
refund_statusenumRequiredRefund progress for collected money. Refunds with `reason` `payment_returned` return money the order never received and don't count.
nonepartially_refundedrefunded
settlement_amountsobjectRequiredPayments, refunds, credits, and amounts still owed for the order.
statusenumRequiredWhether the order still accepts changes and new payments. Refunds, fulfillment, disputes, returns, and metadata or note edits continue on a closed order.
openclosed
supported_actionsarray of enumLifecycle actions Flint accepts on the order now, independent of permissions. Always present with merchant credentials.
Not returned with a checkout credential or a customer session
closepayresolve_inventory_exception
updated_atstringWhen the order was last updated, in RFC3339 format.
order_idstringRequiredThe order that purchased this ticket.
order_line_item_idstringRequiredThe purchased ticket tier.
payment_link_idstringRequiredThe event payment link.
statusenumRequiredThe admission lifecycle.
issuedchecked_invoided
supported_actionsarray of enumRequiredActions currently offered for this ticket.
check_inundo_check_invoid
ticket_idstringRequiredUnique ticket identity with the tkt_ prefix.
ticket_numberstringRequiredThe event prefix and sequence, such as GAL001. Numbers are never reused and do not authorize entry.
updated_atstringRequiredWhen the ticket last changed.
versionintegerRequiredPersisted version of this resource's owned state. Expanded resources and external observations can change independently.
voided_atstring or nullRequiredWhen the ticket was permanently voided. Null when the ticket has not been voided.
{
"admission_code_last4": "1234",
"attendee_name": null,
"check_in_method": null,
"checked_in_at": null,
"created_at": "2026-07-03T14:30:00Z",
"order_id": "ord_01KEZF7C00JBKMARG3P06Z224B",
"order_line_item_id": "li_01KEZF7C004XP0V220YVMGQ354",
"payment_link_id": "pl_01KEZF7C00FEBVYY6R0DKKQRWX",
"status": "issued",
"supported_actions": [],
"ticket_id": "tkt_01J00000000000000000000000",
"ticket_number": "GAL001",
"updated_at": "2026-07-03T14:30:00Z",
"version": 1,
"voided_at": null
}List tickets#
/v1/ticketsRequires scope commerce.tickets.read or commerce.tickets.write
Rate limit: read
Lists individual event tickets, newest first by default. Merchant credentials never receive admission codes. The checkout credential of a paid checkout session lists only its own order's tickets: it must send that order_id, may not send other filters, search, sort or expand, and receives admission_code on every ticket that isn't voided, unless the credential came from a launch URL a merchant read or requested after payment. Any other order_id returns 403, as reading another order does. Default order: created_at descending, then ticket_id descending.
Query parameters
page_sizeintegerMaximum number of results to return, from 1 to 100. Defaults to 20.
page_tokenstringOpaque, signed next_page_token from the previous response, bound to the list and caller. Omit on the first request. You may change `page_size` between pages. Reuse it with the same endpoint, filters, sort, and request context. Do not parse or construct tokens. An altered, invalid, expired, or mismatched token returns a validation error.
payment_link_idstringOnly tickets for this event payment link.
order_idstringOnly tickets belonging to this order.
statusarray of enumFilter by ticket status. Values are trimmed and deduplicated in first-seen order; empty or unknown entries are rejected. Values within this filter are ORed; separate filters are ANDed.
issuedchecked_invoided
querystringCase-insensitive text search across ticket number, attendee name, buyer name and buyer email. For Dashboard check-in staff it matches ticket number and attendee name only.
sort_byenumField to sort by. Defaults to created_at; ties are broken by ticket_id.
created_atattendee_name
sort_directionenumSort direction. Defaults to desc.
ascdesc
checked_in_afterstringInclusive lower bound on checked_in_at.
checked_in_beforestringExclusive upper bound on checked_in_at.
expandarray of enumInclude related objects in the response. Supported expansions: order. Include the requested related resources using scoped batch reads for this page. Each relationship requires its existing target read scopes. Expansion changes the representation without changing pagination tokens. Limits: at most 10 unique expand paths per request.
order
Response · 200
The ticket or ticket page.
dataarray of objectRequiredResource, collection, or operation result returned by this request.
admission_codestringThe ticket's 16-character Crockford base32 admission code, the value its QR code holds. A bearer secret: only the paid checkout session's own paying credential receives it, on its own order's tickets that aren't voided. A checkout credential from a launch URL a merchant reads or requests after payment never does. Returned only to the checkout credential; never in webhook payloads.
Not returned with a bearer token
admission_code_last4stringRequiredLast four characters of the current admission code.
attendee_namestring or nullRequiredOptional attendee name. Null when not supplied.
check_in_methodenum or nullRequiredHow the ticket was admitted. Null when the ticket is not checked in.
admission_codemanual
checked_in_atstring or nullRequiredWhen the ticket was admitted. Null when the ticket is not checked in.
created_atstringRequiredWhen the ticket was issued.
orderobjectOrder summary, present only with expand=order. Requires commerce.orders.read.
order_idstringRequiredThe order that purchased this ticket.
order_line_item_idstringRequiredThe purchased ticket tier.
payment_link_idstringRequiredThe event payment link.
statusenumRequiredThe admission lifecycle.
issuedchecked_invoided
supported_actionsarray of enumRequiredActions currently offered for this ticket.
check_inundo_check_invoid
ticket_idstringRequiredUnique ticket identity with the tkt_ prefix.
ticket_numberstringRequiredThe event prefix and sequence, such as GAL001. Numbers are never reused and do not authorize entry.
updated_atstringRequiredWhen the ticket last changed.
versionintegerRequiredPersisted version of this resource's owned state. Expanded resources and external observations can change independently.
voided_atstring or nullRequiredWhen the ticket was permanently voided. Null when the ticket has not been voided.
metaobjectAdditional information about this response.
api_versionstringAPI version used to produce this response.
idempotency_replayedbooleanWhether this response replays a stored result for the supplied Idempotency-Key.
trace_idstringTrace identifier to include when contacting Flint about this request.
warningsarray of objectConditions that need attention even though the request succeeded.
next_page_tokenstringOpaque token to send as `page_token` to retrieve the next page. Omitted when there is no next page.
request_idstringRequiredIdentifier of this API request, used to correlate logs and support requests.
curl https://api.withflintpay.com/v1/tickets \
-H "Flint-Version: 2026-09-07" \
-H "Authorization: Bearer YOUR_API_KEY"The ticket or ticket page.
{
"data": [
{
"admission_code_last4": "1234",
"attendee_name": null,
"check_in_method": null,
"checked_in_at": null,
"created_at": "2026-07-03T14:30:00Z",
"order_id": "ord_01KEZF7C00JBKMARG3P06Z224B",
"order_line_item_id": "li_01KEZF7C004XP0V220YVMGQ354",
"payment_link_id": "pl_01KEZF7C00FEBVYY6R0DKKQRWX",
"status": "issued",
"supported_actions": [],
"ticket_id": "tkt_01J00000000000000000000000",
"ticket_number": "GAL001",
"updated_at": "2026-07-03T14:30:00Z",
"version": 1,
"voided_at": null
}
],
"meta": {
"api_version": "2026-09-07"
},
"next_page_token": "example",
"request_id": "req_01KWM6WAHG3N9Q8T2V5XRZ7C4D"
}Get a ticket#
/v1/tickets/{ticket_id}Requires scope commerce.tickets.read or commerce.tickets.write
Rate limit: read
Returns an individual ticket. Merchant credentials never receive its admission code. The checkout credential of a paid checkout session reads only its own order's tickets, without expand, and receives admission_code unless the ticket is voided or the credential came from a launch URL a merchant read or requested after payment; another order's ticket returns 404 RESOURCE_NOT_FOUND.
Path parameters
ticket_idstringRequiredThe ticket ID. Must be a valid ID with prefix tkt_. Malformed IDs return 400 INVALID_REQUEST with detail INVALID_VALUE; well-formed IDs that do not exist return 404 RESOURCE_NOT_FOUND.
Query parameters
expandarray of enumInclude related objects in the response. Supported expansions: order. Include the order summary. Limits: at most 10 unique expand paths per request.
order
Response · 200
The ticket or ticket page.
dataobjectRequiredResource, collection, or operation result returned by this request.
admission_codestringThe ticket's 16-character Crockford base32 admission code, the value its QR code holds. A bearer secret: only the paid checkout session's own paying credential receives it, on its own order's tickets that aren't voided. A checkout credential from a launch URL a merchant reads or requests after payment never does. Returned only to the checkout credential; never in webhook payloads.
Not returned with a bearer token
admission_code_last4stringRequiredLast four characters of the current admission code.
attendee_namestring or nullRequiredOptional attendee name. Null when not supplied.
check_in_methodenum or nullRequiredHow the ticket was admitted. Null when the ticket is not checked in.
admission_codemanual
checked_in_atstring or nullRequiredWhen the ticket was admitted. Null when the ticket is not checked in.
created_atstringRequiredWhen the ticket was issued.
orderobjectOrder summary, present only with expand=order. Requires commerce.orders.read.
order_idstringRequiredThe order that purchased this ticket.
order_line_item_idstringRequiredThe purchased ticket tier.
payment_link_idstringRequiredThe event payment link.
statusenumRequiredThe admission lifecycle.
issuedchecked_invoided
supported_actionsarray of enumRequiredActions currently offered for this ticket.
check_inundo_check_invoid
ticket_idstringRequiredUnique ticket identity with the tkt_ prefix.
ticket_numberstringRequiredThe event prefix and sequence, such as GAL001. Numbers are never reused and do not authorize entry.
updated_atstringRequiredWhen the ticket last changed.
versionintegerRequiredPersisted version of this resource's owned state. Expanded resources and external observations can change independently.
voided_atstring or nullRequiredWhen the ticket was permanently voided. Null when the ticket has not been voided.
metaobjectAdditional information about this response.
api_versionstringAPI version used to produce this response.
idempotency_replayedbooleanWhether this response replays a stored result for the supplied Idempotency-Key.
trace_idstringTrace identifier to include when contacting Flint about this request.
warningsarray of objectConditions that need attention even though the request succeeded.
request_idstringRequiredIdentifier of this API request, used to correlate logs and support requests.
curl https://api.withflintpay.com/v1/tickets/tkt_01KEZF7C00AWVKS6GAX8RMEBZ8 \
-H "Flint-Version: 2026-09-07" \
-H "Authorization: Bearer YOUR_API_KEY"The ticket or ticket page.
{
"data": {
"admission_code_last4": "1234",
"attendee_name": null,
"check_in_method": null,
"checked_in_at": null,
"created_at": "2026-07-03T14:30:00Z",
"order_id": "ord_01KEZF7C00JBKMARG3P06Z224B",
"order_line_item_id": "li_01KEZF7C004XP0V220YVMGQ354",
"payment_link_id": "pl_01KEZF7C00FEBVYY6R0DKKQRWX",
"status": "issued",
"supported_actions": [],
"ticket_id": "tkt_01J00000000000000000000000",
"ticket_number": "GAL001",
"updated_at": "2026-07-03T14:30:00Z",
"version": 1,
"voided_at": null
},
"meta": {
"api_version": "2026-09-07"
},
"request_id": "req_01KWM6WAHG3N9Q8T2V5XRZ7C4D"
}Update a ticket#
/v1/tickets/{ticket_id}IdempotentRequires scope commerce.tickets.write
Rate limit: write
Sets the attendee name. Surrounding whitespace is trimmed; send null to clear the name. Sending the current name changes nothing and keeps the version. A voided ticket returns 409 ACTION_NOT_ALLOWED with reason unsupported_state.
Path parameters
ticket_idstringRequiredThe ticket ID. Must be a valid ID with prefix tkt_. Malformed IDs return 400 INVALID_REQUEST with detail INVALID_VALUE; well-formed IDs that do not exist return 404 RESOURCE_NOT_FOUND.
Request body
attendee_namestring or nullRequiredThe attendee name, 1 to 200 characters after surrounding whitespace is trimmed. Send null to clear it.
expected_versionintegerThe ticket version last read. The change applies only while the ticket is at this version; a stale value returns 409 VERSION_CONFLICT, even when the ticket's status would also refuse the change. Door scanners usually omit it.
curl -X PATCH https://api.withflintpay.com/v1/tickets/tkt_01KEZF7C00AWVKS6GAX8RMEBZ8 \
-H "Flint-Version: 2026-09-07" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: a-unique-key" \
-d '{
"attendee_name": "Alex Rivera"
}'Check in a ticket#
/v1/tickets/{ticket_id}/check-inIdempotentRequires scope commerce.tickets.write
Rate limit: write
Admits an issued ticket. Concurrent check-ins of one ticket admit it once: the others return 409 ACTION_NOT_ALLOWED with reason already_applied and current_status checked_in. A stale expected_version returns 409 VERSION_CONFLICT first, so scanners usually omit it. With admission_code the check-in method is admission_code, and the code must be the ticket's current code: a wrong code returns 400 at admission_code and changes nothing. Without a code the method is manual. A voided ticket returns reason unsupported_state. There is no event-time window. The code is never returned or logged.
Path parameters
ticket_idstringRequiredThe ticket ID. Must be a valid ID with prefix tkt_. Malformed IDs return 400 INVALID_REQUEST with detail INVALID_VALUE; well-formed IDs that do not exist return 404 RESOURCE_NOT_FOUND.
Request body
admission_codestringThe 16-character Crockford base32 admission code scanned at the door. Spaces, hyphens and ASCII lowercase are normalized. Omit it to check the ticket in manually.
expected_versionintegerThe ticket version last read. The change applies only while the ticket is at this version; a stale value returns 409 VERSION_CONFLICT, even when the ticket's status would also refuse the change. Door scanners usually omit it.
curl -X POST https://api.withflintpay.com/v1/tickets/tkt_01KEZF7C00AWVKS6GAX8RMEBZ8/check-in \
-H "Flint-Version: 2026-09-07" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: a-unique-key" \
-d '{
"admission_code": "0123456789AB1234"
}'Replace a ticket admission code#
/v1/tickets/{ticket_id}/rotate-codeIdempotentRequires scope commerce.tickets.write
Rate limit: sensitive_write
Replaces the ticket's admission code and returns the new code once, in admission_code. The old code stops working immediately. Use it to deliver tickets yourself with send_ticket_emails turned off. A retry with the same Idempotency-Key within 24 hours returns the code again while the ticket is unchanged since this rotation; after any later change, including another rotation, it returns the ticket without admission_code. A voided ticket returns 409 ACTION_NOT_ALLOWED with reason unsupported_state.
Path parameters
ticket_idstringRequiredThe ticket ID. Must be a valid ID with prefix tkt_. Malformed IDs return 400 INVALID_REQUEST with detail INVALID_VALUE; well-formed IDs that do not exist return 404 RESOURCE_NOT_FOUND.
Request body
expected_versionintegerThe ticket version last read. The change applies only while the ticket is at this version; a stale value returns 409 VERSION_CONFLICT, even when the ticket's status would also refuse the change. Door scanners usually omit it.
Response · 200
The ticket with its new admission code.
dataobjectRequiredResource, collection, or operation result returned by this request.
admission_codestringThe ticket's 16-character Crockford base32 admission code, the value its QR code holds. A bearer secret: only the paid checkout session's own paying credential receives it, on its own order's tickets that aren't voided. A checkout credential from a launch URL a merchant reads or requests after payment never does. Returned only to the checkout credential; never in webhook payloads.
Not returned with a bearer token
admission_code_last4stringRequiredLast four characters of the current admission code.
attendee_namestring or nullRequiredOptional attendee name. Null when not supplied.
check_in_methodenum or nullRequiredHow the ticket was admitted. Null when the ticket is not checked in.
admission_codemanual
checked_in_atstring or nullRequiredWhen the ticket was admitted. Null when the ticket is not checked in.
created_atstringRequiredWhen the ticket was issued.
orderobjectOrder summary, present only with expand=order. Requires commerce.orders.read.
order_idstringRequiredThe order that purchased this ticket.
order_line_item_idstringRequiredThe purchased ticket tier.
payment_link_idstringRequiredThe event payment link.
statusenumRequiredThe admission lifecycle.
issuedchecked_invoided
supported_actionsarray of enumRequiredActions currently offered for this ticket.
check_inundo_check_invoid
ticket_idstringRequiredUnique ticket identity with the tkt_ prefix.
ticket_numberstringRequiredThe event prefix and sequence, such as GAL001. Numbers are never reused and do not authorize entry.
updated_atstringRequiredWhen the ticket last changed.
versionintegerRequiredPersisted version of this resource's owned state. Expanded resources and external observations can change independently.
voided_atstring or nullRequiredWhen the ticket was permanently voided. Null when the ticket has not been voided.
metaobjectAdditional information about this response.
api_versionstringAPI version used to produce this response.
idempotency_replayedbooleanWhether this response replays a stored result for the supplied Idempotency-Key.
trace_idstringTrace identifier to include when contacting Flint about this request.
warningsarray of objectConditions that need attention even though the request succeeded.
request_idstringRequiredIdentifier of this API request, used to correlate logs and support requests.
curl -X POST https://api.withflintpay.com/v1/tickets/tkt_01KEZF7C00AWVKS6GAX8RMEBZ8/rotate-code \
-H "Flint-Version: 2026-09-07" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: a-unique-key" \
-d '{
"expected_version": 2
}'Undo a ticket check-in#
/v1/tickets/{ticket_id}/undo-check-inIdempotentRequires scope commerce.tickets.write
Rate limit: write
Returns a checked-in ticket to issued and clears checked_in_at and check_in_method. An issued ticket returns 409 ACTION_NOT_ALLOWED with reason already_applied; a voided ticket returns reason unsupported_state.
Path parameters
ticket_idstringRequiredThe ticket ID. Must be a valid ID with prefix tkt_. Malformed IDs return 400 INVALID_REQUEST with detail INVALID_VALUE; well-formed IDs that do not exist return 404 RESOURCE_NOT_FOUND.
Request body
expected_versionintegerThe ticket version last read. The change applies only while the ticket is at this version; a stale value returns 409 VERSION_CONFLICT, even when the ticket's status would also refuse the change. Door scanners usually omit it.
curl -X POST https://api.withflintpay.com/v1/tickets/tkt_01KEZF7C00AWVKS6GAX8RMEBZ8/undo-check-in \
-H "Flint-Version: 2026-09-07" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: a-unique-key" \
-d '{
"expected_version": 2
}'Void a ticket#
/v1/tickets/{ticket_id}/voidIdempotentRequires scope commerce.tickets.write
Rate limit: write
Permanently voids an issued or checked-in ticket and releases its seat: the payment link's total_quantity_sold drops by one in the same transaction. Like a refund release, this doesn't change the link's version or send payment_link.updated. Nothing is refunded and the order's ticketed_event doesn't change. A later full refund of the order releases only its remaining valid tickets. A voided ticket returns 409 ACTION_NOT_ALLOWED with reason already_applied.
Path parameters
ticket_idstringRequiredThe ticket ID. Must be a valid ID with prefix tkt_. Malformed IDs return 400 INVALID_REQUEST with detail INVALID_VALUE; well-formed IDs that do not exist return 404 RESOURCE_NOT_FOUND.
Request body
expected_versionintegerThe ticket version last read. The change applies only while the ticket is at this version; a stale value returns 409 VERSION_CONFLICT, even when the ticket's status would also refuse the change. Door scanners usually omit it.
curl -X POST https://api.withflintpay.com/v1/tickets/tkt_01KEZF7C00AWVKS6GAX8RMEBZ8/void \
-H "Flint-Version: 2026-09-07" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: a-unique-key" \
-d '{
"expected_version": 2
}'Look up a ticket#
/v1/tickets/lookupRequires scope commerce.tickets.read or commerce.tickets.write
Rate limit: read
Looks up an admission code in the authenticated merchant and environment, including voided tickets. ASCII lowercase, spaces and hyphens are accepted; O maps to 0 and I/L to 1. Malformed codes return 400 INVALID_REQUEST with detail INVALID_VALUE; an unknown or foreign code returns 404 RESOURCE_NOT_FOUND at admission_code. The code is never returned.
Request body
admission_codestringRequiredThe 16-character Crockford base32 admission code. Spaces, hyphens and ASCII lowercase are normalized.
curl -X POST https://api.withflintpay.com/v1/tickets/lookup \
-H "Flint-Version: 2026-09-07" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"admission_code": "0123456789AB1234"
}'Was this helpful?