BillyDocumentation

List tickets

Retrieves a paginated list of tickets belonging to your Billy organization sorted by their issuance date (issued_at DESC).

GET
/v1/tickets

Retrieves a paginated list of tickets belonging to your Billy organization sorted by their issuance date (issued_at DESC).

Authorization

HTTPBearer
AuthorizationBearer <token>

API key authentication. Format: Bearer billy:o:<organization_id>:<api_key>

Example: Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx

In: header

Query Parameters

page?Page

Page index (1-based, e.g., 1 for first page, 2 for second page)

Range1 <= value
Default1
perPage?|

Maximum number of records to return

updatedAt.gte?|

Return results where updatedAt is at or after this value. For datetime fields, use ISO 8601 format with timezone offset (e.g. 2026-03-01T00:00:00+02:00).

updatedAt.lte?|

Return results where updatedAt is at or before this value. For datetime fields, use ISO 8601 format with timezone offset (e.g. 2026-03-01T00:00:00+02:00).

eventIds?|

Filter by event ID (comma separated, max 10)

sessionIds?|

Filter by session ID (comma separated, max 10)

qrCodes?|

Filter by the ticket's QR code, the value reported as qrCode (exact match, comma separated, max 10)

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/tickets"
{  "items": [    {      "ticketId": "a385b297-a4d0-47fd-ab18-dd5bb56eebc3",      "eventId": "34280fd9-3f2f-4831-90ec-d76ac0cb7c8b",      "invoiceReference": "FR12345678901",      "status": "FULFILLED",      "offerId": "a9e51970-77db-4439-b1d8-7432203e04a2",      "offerName": "VIP",      "issuedAt": "2025-02-10T14:22:05.000Z",      "updatedAt": "2025-02-10T14:22:05.000Z",      "cancelledAt": null,      "eventSessionId": "6095dfdb-aa90-4d18-b0cb-3f9ef4b82238",      "eventSessionStartAt": "2025-03-21T19:30:00.000Z",      "seatingInfo": {        "blocName": "Bloc A",        "seatRow": "B",        "seatNumber": "12"      },      "qrCode": "1234567891011",      "issuanceChannel": "ONLINE_EVENT_SHOP",      "salesChannelName": "Default online store",      "salesChannelId": "5ad8d09e-c789-49e6-a8f8-1434f880beeb",      "orderId": "b2c8c0d4-1f2e-4a3b-9c6d-2e7f1a8b3c4d",      "orderNumber": "QASQTFGU",      "priceLabel": "PLEIN TARIF",      "listPrice": 120,      "finalPaidPrice": 100,      "vat": 20,      "currency": "EUR",      "transferable": false,      "customer": {        "customerId": "eecedea0-e9ed-44d9-9fbf-6cc24a2b2bf4",        "firstName": "Claire",        "lastName": "Dupont",        "email": "claire.dupont@email.com"      },      "attendeeForm": {        "formId": "af_01ABC:ev_01ABC:org_01ABC:2",        "submittedAt": "2026-03-05T13:17:46.076463+00:00",        "responses": [          {            "fieldId": "first-name",            "value": [              "Claire"            ]          },          {            "fieldId": "last-name",            "value": [              "Dupont"            ]          },          {            "fieldId": "dietary-restrictions",            "value": [              "vegetarian",              "gluten-free"            ]          }        ]      }    }  ],  "page": 1,  "perPage": 20,  "totalPages": 1}