List tickets
Retrieves a paginated list of tickets belonging to your Billy organization sorted by their issuance date (issued_at DESC).
Retrieves a paginated list of tickets belonging to your Billy organization sorted by their issuance date (issued_at DESC).
Authorization
HTTPBearer API key authentication. Format: Bearer billy:o:<organization_id>:<api_key>
Example: Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx
In: header
Query Parameters
Page index (1-based, e.g., 1 for first page, 2 for second page)
1 <= value1Maximum number of records to return
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).
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).
Filter by event ID (comma separated, max 10)
Filter by session ID (comma separated, max 10)
Filter by the ticket's QR code, the value reported as qrCode (exact match, comma separated, max 10)
Filter by the order the ticket belongs to, the value reported as orderId (comma separated, max 10). Guest tickets belong to no order and never match. Reads an order's tickets in one call, to group option tickets under their baseTicketId.
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": "VALID", "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, "baseTicketId": null, "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" ] } ] } }, { "ticketId": "7d0c5e21-3b8a-4f6e-9a14-c2d8e0f1b3a7", "eventId": "168c36ec-2e28-4312-be93-8893f0cc4d5e", "invoiceReference": null, "status": "VALID", "offerId": "4c5d6e7f-8091-4a2b-b3c4-d5e6f7a8b9c0", "offerName": "Place accompagnant", "issuedAt": "2025-02-09T18:04:41.000Z", "updatedAt": "2025-02-09T18:04:41.000Z", "cancelledAt": null, "eventSessionId": "11223344-5566-4778-899a-bbccddeeff00", "eventSessionStartAt": "2025-03-15T14:00:00.000Z", "seatingInfo": null, "qrCode": "1234567891012", "issuanceChannel": "ONLINE_EVENT_SHOP", "salesChannelName": "Default online store", "salesChannelId": "5ad8d09e-c789-49e6-a8f8-1434f880beeb", "orderId": "e4a1b7c2-6d3f-4e8a-9b05-7c1d2e3f4a5b", "orderNumber": "KQ7ZP2MX", "pricingId": "5e6f7a8b-9c0d-4e1f-a2b3-c4d5e6f7a8b9", "priceLabel": "Tarif accompagnant", "listPrice": 6, "finalPaidPrice": 6, "vat": 1, "currency": "EUR", "transferable": false, "baseTicketId": "f2b8d4a6-1c3e-4b5d-8e7f-9a0b1c2d3e4f", "customer": { "customerId": "3c9e1a7b-5d2f-4c8e-b0a6-e4f2d8c6a1b3", "firstName": "Louis", "lastName": "Martin", "email": "louis.martin@email.com" }, "attendeeForm": null } ], "page": 1, "perPage": 20, "totalPages": 1}