BillyDocumentation

Retrieve a ticket

Retrieves a single ticket by its identifier — the same object `GET /tickets` lists, `transferable` included, so one ticket can be checked without paging through its event. Returns 404 when the ticket does not exist or does not belong to your organization.

GET
/v1/tickets/{ticket_id}

Retrieves a single ticket by its identifier — the same object GET /tickets lists, transferable included, so one ticket can be checked without paging through its event. Returns 404 when the ticket does not exist or does not belong to your organization.

Authorization

HTTPBearer
AuthorizationBearer <token>

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

Example: Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx

In: header

Path Parameters

ticket_id*Ticket Id

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/tickets/string"
{  "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"        ]      }    ]  }}