{"openapi":"3.1.0","info":{"title":"Billy API Platform","description":"API for Billy platform","version":"1.0.0"},"servers":[{"url":"","description":"Default Server"}],"paths":{"/v1/events":{"get":{"tags":["Events"],"summary":"List events","description":"Retrieves a paginated list of events belonging to your Billy organization. Each item carries flat session summary fields; use GET /v1/events/{event_id}/sessions to enumerate the sessions of an event.","operationId":"get_events_v1_events_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page index (1-based, e.g., 1 for first page, 2 for second page)","default":1,"title":"Page"},"description":"Page index (1-based, e.g., 1 for first page, 2 for second page)"},{"name":"perPage","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100,"minimum":1},{"type":"null"}],"description":"Maximum number of records to return","title":"Perpage"},"description":"Maximum number of records to return"},{"name":"startAt.gte","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Return results where startAt 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).","title":"Startat.Gte"},"description":"Return results where startAt 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)."},{"name":"startAt.lte","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Return results where startAt 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).","title":"Startat.Lte"},"description":"Return results where startAt 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)."},{"name":"tags","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by tag (comma separated, max 10). Returns events linked to any of the given tags (e.g. tags=rap music,jazz). Matching is case- and whitespace-insensitive (accents are kept) and scoped to your organization's tags.","examples":["rap music,jazz"],"title":"Tags"},"description":"Filter by tag (comma separated, max 10). Returns events linked to any of the given tags (e.g. tags=rap music,jazz). Matching is case- and whitespace-insensitive (accents are kept) and scoped to your organization's tags."}],"responses":{"200":{"description":"Successful response: A paginated list of events of your organization.","content":{"application/json":{"schema":{"title":"Response Get Events V1 Events Get","$ref":"#/components/schemas/AllEventsApiResponse"},"examples":{"events_list":{"summary":"A paginated list of events","value":{"items":[{"id":"evt_64f1c2a9e8b4a12f9c0a1234","createdAt":"2025-01-15T10:42:31.000Z","updatedAt":"2025-01-20T09:12:05.000Z","title":"Electro Night Festival","description":"An immersive electronic music experience with top international DJs.","imageUrl":"https://cdn.example.com/events/electro-night/banner.jpg","venueName":"La Grande Halle","venueAddress":{"addressLine1":"211 Avenue Jean Jaurès","addressLine2":null,"city":"Paris","postalCode":"75019","countryCode":"FR"},"eventTimezone":"Europe/Paris","currency":"EUR","sessionCount":1,"firstSessionStartAt":"2025-03-21T19:30:00+01:00","lastSessionStartAt":"2025-03-21T19:30:00+01:00","nextSessionStartAt":null,"nextSessionId":null,"tags":["concert","electro"]}],"page":1,"perPage":10,"totalPages":1}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"examples":{"missing_api_key":{"summary":"Missing API key","value":{"detail":"API key required in AUTHORIZATION header, Expected: 'Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx'"}},"invalid_api_key_format":{"summary":"Invalid API key format","value":{"detail":"Invalid API key format. Value: 'xxxxxxxxxxxxxxxS', Expected: 'Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx'"}},"invalid_query_parameters":{"summary":"Invalid query parameters","value":{"detail":"Invalid query parameters","errors":[{"loc":"query.page","input":"0","ctx":"{'ge': 1}"}]}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"examples":{"api_key_not_found":{"summary":"API key not found or invalid","value":{"detail":"Forbidden : API key not found"}},"api_key_revoked":{"summary":"API key revoked","value":{"detail":"Forbidden : API key revoked"}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"429":{"description":"Too Many Requests - (Http response header 'Retry-After' in seconds)","content":{"application/json":{"examples":{"too_many_requests":{"summary":"Rate limit exceeded","value":{"detail":"Too Many Requests - backpressure applied (Header 'Retry-After' in seconds)"}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"204":{"description":"Out of pagination","content":{"application/json":{"examples":{"out-of-range":{"summary":"Outside the page range","value":null}}}}}}}},"/v1/events/{event_id}":{"get":{"tags":["Events"],"summary":"Retrieve an event","description":"Retrieves a single event by its identifier. Use GET /v1/events/{event_id}/sessions to enumerate the event sessions. Returns 404 when the event does not exist or does not belong to your organization.","operationId":"get_event_v1_events__event_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"string","title":"Event Id"}}],"responses":{"200":{"description":"Successful response: The event matching the given identifier.","content":{"application/json":{"schema":{"title":"Response Get Event V1 Events  Event Id  Get","$ref":"#/components/schemas/EventApiResponse"},"examples":{"event_detail":{"summary":"A single event","value":{"id":"evt_64f1c2a9e8b4a12f9c0a1234","createdAt":"2025-01-15T10:42:31.000Z","updatedAt":"2025-01-20T09:12:05.000Z","title":"Electro Night Festival","description":"An immersive electronic music experience with top international DJs.","imageUrl":"https://cdn.example.com/events/electro-night/banner.jpg","venueName":"La Grande Halle","venueAddress":{"addressLine1":"211 Avenue Jean Jaurès","addressLine2":null,"city":"Paris","postalCode":"75019","countryCode":"FR"},"eventTimezone":"Europe/Paris","currency":"EUR","sessionCount":1,"firstSessionStartAt":"2025-03-21T19:30:00+01:00","lastSessionStartAt":"2025-03-21T19:30:00+01:00","nextSessionStartAt":null,"nextSessionId":null,"tags":["concert","electro"]}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"examples":{"missing_api_key":{"summary":"Missing API key","value":{"detail":"API key required in AUTHORIZATION header, Expected: 'Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx'"}},"invalid_api_key_format":{"summary":"Invalid API key format","value":{"detail":"Invalid API key format. Value: 'xxxxxxxxxxxxxxxS', Expected: 'Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx'"}},"invalid_query_parameters":{"summary":"Invalid query parameters","value":{"detail":"Invalid query parameters","errors":[{"loc":"query.page","input":"0","ctx":"{'ge': 1}"}]}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"examples":{"api_key_not_found":{"summary":"API key not found or invalid","value":{"detail":"Forbidden : API key not found"}},"api_key_revoked":{"summary":"API key revoked","value":{"detail":"Forbidden : API key revoked"}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"429":{"description":"Too Many Requests - (Http response header 'Retry-After' in seconds)","content":{"application/json":{"examples":{"too_many_requests":{"summary":"Rate limit exceeded","value":{"detail":"Too Many Requests - backpressure applied (Header 'Retry-After' in seconds)"}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"404":{"description":"Event not found"}}}},"/v1/events/{event_id}/sessions":{"get":{"tags":["Events"],"summary":"List event sessions","description":"Retrieves the complete paginated list of sessions of an event, ordered by start date. Supports startAt range filters. Returns 404 when the event does not exist or does not belong to your organization.","operationId":"get_event_sessions_v1_events__event_id__sessions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"string","title":"Event Id"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page index (1-based, e.g., 1 for first page, 2 for second page)","default":1,"title":"Page"},"description":"Page index (1-based, e.g., 1 for first page, 2 for second page)"},{"name":"perPage","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100,"minimum":1},{"type":"null"}],"description":"Maximum number of records to return","title":"Perpage"},"description":"Maximum number of records to return"},{"name":"startAt.gte","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Return results where startAt 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).","title":"Startat.Gte"},"description":"Return results where startAt 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)."},{"name":"startAt.gt","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Return results where startAt is strictly after this value. For datetime fields, use ISO 8601 format with timezone offset (e.g. 2026-03-01T00:00:00+02:00).","title":"Startat.Gt"},"description":"Return results where startAt is strictly after this value. For datetime fields, use ISO 8601 format with timezone offset (e.g. 2026-03-01T00:00:00+02:00)."},{"name":"startAt.lte","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Return results where startAt 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).","title":"Startat.Lte"},"description":"Return results where startAt 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)."},{"name":"startAt.lt","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Return results where startAt is strictly before this value. For datetime fields, use ISO 8601 format with timezone offset (e.g. 2026-03-01T00:00:00+02:00).","title":"Startat.Lt"},"description":"Return results where startAt is strictly before this value. For datetime fields, use ISO 8601 format with timezone offset (e.g. 2026-03-01T00:00:00+02:00)."}],"responses":{"200":{"description":"Successful response: A paginated list of the event sessions.","content":{"application/json":{"schema":{"title":"Response Get Event Sessions V1 Events  Event Id  Sessions Get","$ref":"#/components/schemas/AllEventSessionsApiResponse"},"examples":{"event_sessions_list":{"summary":"A paginated list of event sessions","value":{"items":[{"id":"68799a92-c357-454d-afa5-54ed51f1f98f","startAt":"2025-03-21T19:30:00+01:00","durationMinutes":180},{"id":"8b1c0f77-95d1-4f0e-9f5a-0f6f1d3f98aa","startAt":"2025-03-22T19:30:00+01:00","durationMinutes":180}],"page":1,"perPage":100,"totalPages":1}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"examples":{"missing_api_key":{"summary":"Missing API key","value":{"detail":"API key required in AUTHORIZATION header, Expected: 'Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx'"}},"invalid_api_key_format":{"summary":"Invalid API key format","value":{"detail":"Invalid API key format. Value: 'xxxxxxxxxxxxxxxS', Expected: 'Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx'"}},"invalid_query_parameters":{"summary":"Invalid query parameters","value":{"detail":"Invalid query parameters","errors":[{"loc":"query.page","input":"0","ctx":"{'ge': 1}"}]}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"examples":{"api_key_not_found":{"summary":"API key not found or invalid","value":{"detail":"Forbidden : API key not found"}},"api_key_revoked":{"summary":"API key revoked","value":{"detail":"Forbidden : API key revoked"}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"429":{"description":"Too Many Requests - (Http response header 'Retry-After' in seconds)","content":{"application/json":{"examples":{"too_many_requests":{"summary":"Rate limit exceeded","value":{"detail":"Too Many Requests - backpressure applied (Header 'Retry-After' in seconds)"}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"204":{"description":"Out of pagination","content":{"application/json":{"examples":{"out-of-range":{"summary":"Outside the page range","value":null}}}}},"404":{"description":"Event not found"}}}},"/v1/tickets":{"get":{"tags":["Tickets"],"summary":"List tickets","description":"Retrieves a paginated list of tickets belonging to your Billy organization sorted by their issuance date (issued_at DESC).","operationId":"get_tickets_v1_tickets_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page index (1-based, e.g., 1 for first page, 2 for second page)","default":1,"title":"Page"},"description":"Page index (1-based, e.g., 1 for first page, 2 for second page)"},{"name":"perPage","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100,"minimum":1},{"type":"null"}],"description":"Maximum number of records to return","title":"Perpage"},"description":"Maximum number of records to return"},{"name":"updatedAt.gte","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"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).","title":"Updatedat.Gte"},"description":"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)."},{"name":"updatedAt.lte","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"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).","title":"Updatedat.Lte"},"description":"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)."},{"name":"eventIds","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by event ID (comma separated, max 10)","examples":["331704d8-50bf-4e99-8d82-95c4974bxxxx,168c36ec-2e28-4312-be93-8893f0ccxxxx"],"title":"Eventids"},"description":"Filter by event ID (comma separated, max 10)"},{"name":"sessionIds","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by session ID (comma separated, max 10)","examples":["331704d8-50bf-4e99-8d82-95c4974bxxxx,168c36ec-2e28-4312-be93-8893f0ccxxxx"],"title":"Sessionids"},"description":"Filter by session ID (comma separated, max 10)"},{"name":"qrCodes","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by the ticket's QR code, the value reported as `qrCode` (exact match, comma separated, max 10)","examples":["1234567891011,1234567891012"],"title":"Qrcodes"},"description":"Filter by the ticket's QR code, the value reported as `qrCode` (exact match, comma separated, max 10)"}],"responses":{"200":{"description":"Successful response: A paginated list of tickets of your organization.","content":{"application/json":{"schema":{"title":"Response Get Tickets V1 Tickets Get","$ref":"#/components/schemas/AllTicketsApiResponse"},"examples":{"tickets_list":{"summary":"A paginated list of tickets","value":{"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.0,"finalPaidPrice":100.0,"vat":20.0,"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}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"examples":{"missing_api_key":{"summary":"Missing API key","value":{"detail":"API key required in AUTHORIZATION header, Expected: 'Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx'"}},"invalid_api_key_format":{"summary":"Invalid API key format","value":{"detail":"Invalid API key format. Value: 'xxxxxxxxxxxxxxxS', Expected: 'Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx'"}},"invalid_query_parameters":{"summary":"Invalid query parameters","value":{"detail":"Invalid query parameters","errors":[{"loc":"query.page","input":"0","ctx":"{'ge': 1}"}]}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"examples":{"api_key_not_found":{"summary":"API key not found or invalid","value":{"detail":"Forbidden : API key not found"}},"api_key_revoked":{"summary":"API key revoked","value":{"detail":"Forbidden : API key revoked"}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"429":{"description":"Too Many Requests - (Http response header 'Retry-After' in seconds)","content":{"application/json":{"examples":{"too_many_requests":{"summary":"Rate limit exceeded","value":{"detail":"Too Many Requests - backpressure applied (Header 'Retry-After' in seconds)"}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"204":{"description":"Out of pagination","content":{"application/json":{"examples":{"out-of-range":{"summary":"Outside the page range","value":null}}}}}}}},"/v1/tickets/{ticket_id}":{"get":{"tags":["Tickets"],"summary":"Retrieve a ticket","description":"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.","operationId":"get_ticket_v1_tickets__ticket_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"string","title":"Ticket Id"}}],"responses":{"200":{"description":"Successful response: The ticket matching the given identifier.","content":{"application/json":{"schema":{"title":"Response Get Ticket V1 Tickets  Ticket Id  Get","$ref":"#/components/schemas/TicketApiResponse"},"examples":{"ticket_detail":{"summary":"A single ticket","value":{"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.0,"finalPaidPrice":100.0,"vat":20.0,"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"]}]}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"examples":{"missing_api_key":{"summary":"Missing API key","value":{"detail":"API key required in AUTHORIZATION header, Expected: 'Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx'"}},"invalid_api_key_format":{"summary":"Invalid API key format","value":{"detail":"Invalid API key format. Value: 'xxxxxxxxxxxxxxxS', Expected: 'Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx'"}},"invalid_query_parameters":{"summary":"Invalid query parameters","value":{"detail":"Invalid query parameters","errors":[{"loc":"query.page","input":"0","ctx":"{'ge': 1}"}]}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"examples":{"api_key_not_found":{"summary":"API key not found or invalid","value":{"detail":"Forbidden : API key not found"}},"api_key_revoked":{"summary":"API key revoked","value":{"detail":"Forbidden : API key revoked"}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"429":{"description":"Too Many Requests - (Http response header 'Retry-After' in seconds)","content":{"application/json":{"examples":{"too_many_requests":{"summary":"Rate limit exceeded","value":{"detail":"Too Many Requests - backpressure applied (Header 'Retry-After' in seconds)"}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"404":{"description":"Ticket not found"}}}},"/v1/orders":{"get":{"tags":["Orders"],"summary":"List orders","description":"Retrieves a paginated list of orders belonging to your Billy organization sorted by their creation date (created_at DESC).","operationId":"get_orders_v1_orders_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page index (1-based, e.g., 1 for first page, 2 for second page)","default":1,"title":"Page"},"description":"Page index (1-based, e.g., 1 for first page, 2 for second page)"},{"name":"perPage","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100,"minimum":1},{"type":"null"}],"description":"Maximum number of records to return","title":"Perpage"},"description":"Maximum number of records to return"},{"name":"updatedAt.gte","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"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).","title":"Updatedat.Gte"},"description":"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)."},{"name":"updatedAt.lte","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"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).","title":"Updatedat.Lte"},"description":"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)."},{"name":"eventIds","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Returns orders that contain at least one item from any of the given event IDs (comma separated, max 10).","examples":["331704d8-50bf-4e99-8d82-95c4974bxxxx,168c36ec-2e28-4312-be93-8893f0ccxxxx"],"title":"Eventids"},"description":"Returns orders that contain at least one item from any of the given event IDs (comma separated, max 10)."},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by order status (PENDING, FULFILLED, CANCELLED)","examples":["FULFILLED"],"title":"Status"},"description":"Filter by order status (PENDING, FULFILLED, CANCELLED)"},{"name":"email","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by the customer's email, the value reported as `customer.email` (exact match, case-insensitive)","examples":["alice.martin@example.com"],"title":"Email"},"description":"Filter by the customer's email, the value reported as `customer.email` (exact match, case-insensitive)"}],"responses":{"200":{"description":"Successful response: A paginated list of orders of your organization.","content":{"application/json":{"schema":{"title":"Response Get Orders V1 Orders Get","$ref":"#/components/schemas/AllOrdersApiResponse"},"examples":{"orders_list":{"summary":"A paginated list of orders","value":{"items":[{"orderId":"b2c8c0d4-1f2e-4a3b-9c6d-2e7f1a8b3c4d","orderNumber":"XI3RHEF","salesChannelId":"5ad8d09e-c789-49e6-a8f8-1434f880beeb","salesChannelName":"Box Office","status":"FULFILLED","customer":{"customerId":"eecedea0-e9ed-44d9-9fbf-6cc24a2b2bf4","email":"jane@example.com","firstName":"Jane","lastName":"Doe"},"billingAddress":{"type":"personal","firstName":"Jane","lastName":"Doe","companyName":null,"vatNumber":null,"phone":"+33612345678","addressLine1":"12 Rue de la Paix","addressLine2":null,"city":"Paris","postalCode":"75001","countryCode":"FR"},"currency":"EUR","totalPrice":150.0,"totalPaidPrice":140.0,"subtotalPrice":130.0,"subtotalPaidPrice":120.0,"discountAmount":10.0,"discountCode":"SUMMER10","paymentProvider":"Stripe","paymentMethod":"VISA","serviceFees":5.0,"deliveryFees":2.5,"totalVatAmount":25.0,"delivery":{"type":"home_delivery","carrierId":"carrier_001","homeDeliveryAddress":{"type":"personal","firstName":"Jane","lastName":"Doe","addressLine1":"12 Rue de la Paix","addressLine2":null,"city":"Paris","postalCode":"75001","countryCode":"FR"},"pickupPoint":null},"placedItems":[{"offerId":"a9e51970-77db-4439-b1d8-7432203e04a2","offerName":"Early Bird - General Admission","inventoryId":"63c4f1e7-2b8a-4c9d-8e1f-5a6b7c8d9e0f","quantity":2,"unitPrice":65.0,"unitPaidPrice":60.0,"unitDiscountAmount":5.0,"discountCode":"SUMMER10","priceLabel":"Early Bird","offerType":"TICKET","eventId":"34280fd9-3f2f-4831-90ec-d76ac0cb7c8b","sessionId":"6095dfdb-aa90-4d18-b0cb-3f9ef4b82238","unitVatAmount":10.0}],"optIns":[{"name":"Marketing emails","accepted":true}],"createdAt":"2024-03-15T14:30:00Z","fulfilledAt":"2024-03-15T14:35:00Z","cancelledAt":null,"updatedAt":"2024-03-15T14:35:00Z","paymentStatus":"PAID","refundedAmount":null,"ticketsProtected":true,"addOns":[{"category":"INSURANCE","serviceId":"neat","serviceName":"Neat","addOnPaidPrice":3.6},{"category":"DONATION","serviceId":"common-cents","serviceName":"Common Cents","addOnPaidPrice":1.0}]}],"page":1,"perPage":20,"totalPages":1}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"examples":{"missing_api_key":{"summary":"Missing API key","value":{"detail":"API key required in AUTHORIZATION header, Expected: 'Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx'"}},"invalid_api_key_format":{"summary":"Invalid API key format","value":{"detail":"Invalid API key format. Value: 'xxxxxxxxxxxxxxxS', Expected: 'Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx'"}},"invalid_query_parameters":{"summary":"Invalid query parameters","value":{"detail":"Invalid query parameters","errors":[{"loc":"query.page","input":"0","ctx":"{'ge': 1}"}]}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"examples":{"api_key_not_found":{"summary":"API key not found or invalid","value":{"detail":"Forbidden : API key not found"}},"api_key_revoked":{"summary":"API key revoked","value":{"detail":"Forbidden : API key revoked"}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"429":{"description":"Too Many Requests - (Http response header 'Retry-After' in seconds)","content":{"application/json":{"examples":{"too_many_requests":{"summary":"Rate limit exceeded","value":{"detail":"Too Many Requests - backpressure applied (Header 'Retry-After' in seconds)"}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"204":{"description":"Out of pagination","content":{"application/json":{"examples":{"out-of-range":{"summary":"Outside the page range","value":null}}}}}}}},"/v1/orders/{order_id}":{"get":{"tags":["Orders"],"summary":"Retrieve an order","description":"Retrieves a single order by its identifier. Returns 404 when the order does not exist or does not belong to your organization.","operationId":"get_order_v1_orders__order_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful response: The order matching the given identifier.","content":{"application/json":{"schema":{"title":"Response Get Order V1 Orders  Order Id  Get","$ref":"#/components/schemas/OrderApiResponse"},"examples":{"order_detail":{"summary":"A single order","value":{"orderId":"b2c8c0d4-1f2e-4a3b-9c6d-2e7f1a8b3c4d","orderNumber":"XI3RHEF","salesChannelId":"5ad8d09e-c789-49e6-a8f8-1434f880beeb","salesChannelName":"Box Office","status":"FULFILLED","customer":{"customerId":"eecedea0-e9ed-44d9-9fbf-6cc24a2b2bf4","email":"jane@example.com","firstName":"Jane","lastName":"Doe"},"billingAddress":{"type":"personal","firstName":"Jane","lastName":"Doe","companyName":null,"vatNumber":null,"phone":"+33612345678","addressLine1":"12 Rue de la Paix","addressLine2":null,"city":"Paris","postalCode":"75001","countryCode":"FR"},"currency":"EUR","totalPrice":150.0,"totalPaidPrice":140.0,"subtotalPrice":130.0,"subtotalPaidPrice":120.0,"discountAmount":10.0,"discountCode":"SUMMER10","paymentProvider":"Stripe","paymentMethod":"VISA","serviceFees":5.0,"deliveryFees":2.5,"totalVatAmount":25.0,"delivery":{"type":"home_delivery","carrierId":"carrier_001","homeDeliveryAddress":{"type":"personal","firstName":"Jane","lastName":"Doe","addressLine1":"12 Rue de la Paix","addressLine2":null,"city":"Paris","postalCode":"75001","countryCode":"FR"},"pickupPoint":null},"placedItems":[{"offerId":"a9e51970-77db-4439-b1d8-7432203e04a2","offerName":"Early Bird - General Admission","inventoryId":"63c4f1e7-2b8a-4c9d-8e1f-5a6b7c8d9e0f","quantity":2,"unitPrice":65.0,"unitPaidPrice":60.0,"unitDiscountAmount":5.0,"discountCode":"SUMMER10","priceLabel":"Early Bird","offerType":"TICKET","eventId":"34280fd9-3f2f-4831-90ec-d76ac0cb7c8b","sessionId":"6095dfdb-aa90-4d18-b0cb-3f9ef4b82238","unitVatAmount":10.0}],"optIns":[{"name":"Marketing emails","accepted":true}],"createdAt":"2024-03-15T14:30:00Z","fulfilledAt":"2024-03-15T14:35:00Z","cancelledAt":null,"updatedAt":"2024-03-15T14:35:00Z","paymentStatus":"PAID","refundedAmount":null,"ticketsProtected":true,"addOns":[{"category":"INSURANCE","serviceId":"neat","serviceName":"Neat","addOnPaidPrice":3.6},{"category":"DONATION","serviceId":"common-cents","serviceName":"Common Cents","addOnPaidPrice":1.0}]}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"examples":{"missing_api_key":{"summary":"Missing API key","value":{"detail":"API key required in AUTHORIZATION header, Expected: 'Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx'"}},"invalid_api_key_format":{"summary":"Invalid API key format","value":{"detail":"Invalid API key format. Value: 'xxxxxxxxxxxxxxxS', Expected: 'Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx'"}},"invalid_query_parameters":{"summary":"Invalid query parameters","value":{"detail":"Invalid query parameters","errors":[{"loc":"query.page","input":"0","ctx":"{'ge': 1}"}]}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"examples":{"api_key_not_found":{"summary":"API key not found or invalid","value":{"detail":"Forbidden : API key not found"}},"api_key_revoked":{"summary":"API key revoked","value":{"detail":"Forbidden : API key revoked"}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"429":{"description":"Too Many Requests - (Http response header 'Retry-After' in seconds)","content":{"application/json":{"examples":{"too_many_requests":{"summary":"Rate limit exceeded","value":{"detail":"Too Many Requests - backpressure applied (Header 'Retry-After' in seconds)"}}},"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"404":{"description":"Order not found"}}}}},"components":{"schemas":{"AddressApiResponse":{"properties":{"type":{"type":"string","enum":["personal","company"],"title":"Type","description":"Address type"},"firstName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Firstname"},"lastName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lastname"},"companyName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Companyname"},"vatNumber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vatnumber"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"addressLine1":{"type":"string","title":"Addressline1"},"addressLine2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Addressline2"},"city":{"type":"string","title":"City"},"postalCode":{"type":"string","title":"Postalcode"},"countryCode":{"type":"string","title":"Countrycode"}},"type":"object","required":["type","addressLine1","city","postalCode","countryCode"],"title":"AddressApiResponse"},"AllEventSessionsApiResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/EventSessionApiResponse"},"type":"array","title":"Items","description":"The list of items"},"page":{"type":"integer","title":"Page","description":"The current page"},"perPage":{"type":"integer","title":"Perpage","description":"The number of items per page"},"totalPages":{"type":"integer","title":"Totalpages","description":"The number of pages"},"hasMore":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Hasmore","description":"Whether there are more pages","default":false},"nextPage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nextpage","description":"url to load next page"}},"type":"object","required":["items","page","perPage","totalPages"],"title":"AllEventSessionsApiResponse"},"AllEventsApiResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/EventApiResponse"},"type":"array","title":"Items","description":"The list of items"},"page":{"type":"integer","title":"Page","description":"The current page"},"perPage":{"type":"integer","title":"Perpage","description":"The number of items per page"},"totalPages":{"type":"integer","title":"Totalpages","description":"The number of pages"},"hasMore":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Hasmore","description":"Whether there are more pages","default":false},"nextPage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nextpage","description":"url to load next page"}},"type":"object","required":["items","page","perPage","totalPages"],"title":"AllEventsApiResponse"},"AllOrdersApiResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/OrderApiResponse"},"type":"array","title":"Items","description":"The list of items"},"page":{"type":"integer","title":"Page","description":"The current page"},"perPage":{"type":"integer","title":"Perpage","description":"The number of items per page"},"totalPages":{"type":"integer","title":"Totalpages","description":"The number of pages"},"hasMore":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Hasmore","description":"Whether there are more pages","default":false},"nextPage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nextpage","description":"url to load next page"}},"type":"object","required":["items","page","perPage","totalPages"],"title":"AllOrdersApiResponse"},"AllTicketsApiResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/TicketApiResponse"},"type":"array","title":"Items","description":"The list of items"},"page":{"type":"integer","title":"Page","description":"The current page"},"perPage":{"type":"integer","title":"Perpage","description":"The number of items per page"},"totalPages":{"type":"integer","title":"Totalpages","description":"The number of pages"},"hasMore":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Hasmore","description":"Whether there are more pages","default":false},"nextPage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nextpage","description":"url to load next page"}},"type":"object","required":["items","page","perPage","totalPages"],"title":"AllTicketsApiResponse"},"CustomerApiResponse":{"properties":{"customerId":{"type":"string","title":"Customerid","description":"The customer identifier"},"email":{"type":"string","title":"Email","description":"The customer email"},"firstName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Firstname","description":"The customer first name"},"lastName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lastname","description":"The customer last name"}},"type":"object","required":["customerId","email"],"title":"CustomerApiResponse","description":"The person who placed the order — the checkout contact block, and nothing more.\n\nThis is the **stable** shape. The customer form's answers are exposed on\n`CustomerPreviewApiResponse` instead, which is what preview callers receive; keep this one\nfrozen until that graduates to a dated release."},"DeliveryApiResponse":{"properties":{"type":{"type":"string","enum":["home_delivery","pickup_point","on_site"],"title":"Type"},"carrierId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Carrierid"},"homeDeliveryAddress":{"anyOf":[{"$ref":"#/components/schemas/AddressApiResponse"},{"type":"null"}]},"pickupPoint":{"anyOf":[{"$ref":"#/components/schemas/PickupPointApiResponse"},{"type":"null"}]}},"type":"object","required":["type"],"title":"DeliveryApiResponse"},"EventApiResponse":{"properties":{"id":{"type":"string","title":"Id","description":"The event identifier"},"createdAt":{"type":"string","title":"Createdat","description":"The event creation date (UTC)"},"updatedAt":{"type":"string","title":"Updatedat","description":"The event last update date (UTC)"},"title":{"type":"string","title":"Title","description":"The event title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"The event description"},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Imageurl","description":"The event image URL"},"venueName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Venuename","description":"The event venue name"},"venueAddress":{"anyOf":[{"$ref":"#/components/schemas/VenueAddressApiResponse"},{"type":"null"}],"description":"The event structured venue address. Null if no structured address is available — this happens when the venue is still stored in the legacy free-text format; edit and save the event's address in the Studio to populate the structured fields."},"eventTimezone":{"type":"string","enum":["Africa/Abidjan","Africa/Accra","Africa/Addis_Ababa","Africa/Algiers","Africa/Asmara","Africa/Asmera","Africa/Bamako","Africa/Bangui","Africa/Banjul","Africa/Bissau","Africa/Blantyre","Africa/Brazzaville","Africa/Bujumbura","Africa/Cairo","Africa/Casablanca","Africa/Ceuta","Africa/Conakry","Africa/Dakar","Africa/Dar_es_Salaam","Africa/Djibouti","Africa/Douala","Africa/El_Aaiun","Africa/Freetown","Africa/Gaborone","Africa/Harare","Africa/Johannesburg","Africa/Juba","Africa/Kampala","Africa/Khartoum","Africa/Kigali","Africa/Kinshasa","Africa/Lagos","Africa/Libreville","Africa/Lome","Africa/Luanda","Africa/Lubumbashi","Africa/Lusaka","Africa/Malabo","Africa/Maputo","Africa/Maseru","Africa/Mbabane","Africa/Mogadishu","Africa/Monrovia","Africa/Nairobi","Africa/Ndjamena","Africa/Niamey","Africa/Nouakchott","Africa/Ouagadougou","Africa/Porto-Novo","Africa/Sao_Tome","Africa/Timbuktu","Africa/Tripoli","Africa/Tunis","Africa/Windhoek","America/Adak","America/Anchorage","America/Anguilla","America/Antigua","America/Araguaina","America/Argentina/Buenos_Aires","America/Argentina/Catamarca","America/Argentina/ComodRivadavia","America/Argentina/Cordoba","America/Argentina/Jujuy","America/Argentina/La_Rioja","America/Argentina/Mendoza","America/Argentina/Rio_Gallegos","America/Argentina/Salta","America/Argentina/San_Juan","America/Argentina/San_Luis","America/Argentina/Tucuman","America/Argentina/Ushuaia","America/Aruba","America/Asuncion","America/Atikokan","America/Atka","America/Bahia","America/Bahia_Banderas","America/Barbados","America/Belem","America/Belize","America/Blanc-Sablon","America/Boa_Vista","America/Bogota","America/Boise","America/Buenos_Aires","America/Cambridge_Bay","America/Campo_Grande","America/Cancun","America/Caracas","America/Catamarca","America/Cayenne","America/Cayman","America/Chicago","America/Chihuahua","America/Ciudad_Juarez","America/Coral_Harbour","America/Cordoba","America/Costa_Rica","America/Coyhaique","America/Creston","America/Cuiaba","America/Curacao","America/Danmarkshavn","America/Dawson","America/Dawson_Creek","America/Denver","America/Detroit","America/Dominica","America/Edmonton","America/Eirunepe","America/El_Salvador","America/Ensenada","America/Fort_Nelson","America/Fort_Wayne","America/Fortaleza","America/Glace_Bay","America/Godthab","America/Goose_Bay","America/Grand_Turk","America/Grenada","America/Guadeloupe","America/Guatemala","America/Guayaquil","America/Guyana","America/Halifax","America/Havana","America/Hermosillo","America/Indiana/Indianapolis","America/Indiana/Knox","America/Indiana/Marengo","America/Indiana/Petersburg","America/Indiana/Tell_City","America/Indiana/Vevay","America/Indiana/Vincennes","America/Indiana/Winamac","America/Indianapolis","America/Inuvik","America/Iqaluit","America/Jamaica","America/Jujuy","America/Juneau","America/Kentucky/Louisville","America/Kentucky/Monticello","America/Knox_IN","America/Kralendijk","America/La_Paz","America/Lima","America/Los_Angeles","America/Louisville","America/Lower_Princes","America/Maceio","America/Managua","America/Manaus","America/Marigot","America/Martinique","America/Matamoros","America/Mazatlan","America/Mendoza","America/Menominee","America/Merida","America/Metlakatla","America/Mexico_City","America/Miquelon","America/Moncton","America/Monterrey","America/Montevideo","America/Montreal","America/Montserrat","America/Nassau","America/New_York","America/Nipigon","America/Nome","America/Noronha","America/North_Dakota/Beulah","America/North_Dakota/Center","America/North_Dakota/New_Salem","America/Nuuk","America/Ojinaga","America/Panama","America/Pangnirtung","America/Paramaribo","America/Phoenix","America/Port-au-Prince","America/Port_of_Spain","America/Porto_Acre","America/Porto_Velho","America/Puerto_Rico","America/Punta_Arenas","America/Rainy_River","America/Rankin_Inlet","America/Recife","America/Regina","America/Resolute","America/Rio_Branco","America/Rosario","America/Santa_Isabel","America/Santarem","America/Santiago","America/Santo_Domingo","America/Sao_Paulo","America/Scoresbysund","America/Shiprock","America/Sitka","America/St_Barthelemy","America/St_Johns","America/St_Kitts","America/St_Lucia","America/St_Thomas","America/St_Vincent","America/Swift_Current","America/Tegucigalpa","America/Thule","America/Thunder_Bay","America/Tijuana","America/Toronto","America/Tortola","America/Vancouver","America/Virgin","America/Whitehorse","America/Winnipeg","America/Yakutat","America/Yellowknife","Antarctica/Casey","Antarctica/Davis","Antarctica/DumontDUrville","Antarctica/Macquarie","Antarctica/Mawson","Antarctica/McMurdo","Antarctica/Palmer","Antarctica/Rothera","Antarctica/South_Pole","Antarctica/Syowa","Antarctica/Troll","Antarctica/Vostok","Arctic/Longyearbyen","Asia/Aden","Asia/Almaty","Asia/Amman","Asia/Anadyr","Asia/Aqtau","Asia/Aqtobe","Asia/Ashgabat","Asia/Ashkhabad","Asia/Atyrau","Asia/Baghdad","Asia/Bahrain","Asia/Baku","Asia/Bangkok","Asia/Barnaul","Asia/Beirut","Asia/Bishkek","Asia/Brunei","Asia/Calcutta","Asia/Chita","Asia/Choibalsan","Asia/Chongqing","Asia/Chungking","Asia/Colombo","Asia/Dacca","Asia/Damascus","Asia/Dhaka","Asia/Dili","Asia/Dubai","Asia/Dushanbe","Asia/Famagusta","Asia/Gaza","Asia/Harbin","Asia/Hebron","Asia/Ho_Chi_Minh","Asia/Hong_Kong","Asia/Hovd","Asia/Irkutsk","Asia/Istanbul","Asia/Jakarta","Asia/Jayapura","Asia/Jerusalem","Asia/Kabul","Asia/Kamchatka","Asia/Karachi","Asia/Kashgar","Asia/Kathmandu","Asia/Katmandu","Asia/Khandyga","Asia/Kolkata","Asia/Krasnoyarsk","Asia/Kuala_Lumpur","Asia/Kuching","Asia/Kuwait","Asia/Macao","Asia/Macau","Asia/Magadan","Asia/Makassar","Asia/Manila","Asia/Muscat","Asia/Nicosia","Asia/Novokuznetsk","Asia/Novosibirsk","Asia/Omsk","Asia/Oral","Asia/Phnom_Penh","Asia/Pontianak","Asia/Pyongyang","Asia/Qatar","Asia/Qostanay","Asia/Qyzylorda","Asia/Rangoon","Asia/Riyadh","Asia/Saigon","Asia/Sakhalin","Asia/Samarkand","Asia/Seoul","Asia/Shanghai","Asia/Singapore","Asia/Srednekolymsk","Asia/Taipei","Asia/Tashkent","Asia/Tbilisi","Asia/Tehran","Asia/Tel_Aviv","Asia/Thimbu","Asia/Thimphu","Asia/Tokyo","Asia/Tomsk","Asia/Ujung_Pandang","Asia/Ulaanbaatar","Asia/Ulan_Bator","Asia/Urumqi","Asia/Ust-Nera","Asia/Vientiane","Asia/Vladivostok","Asia/Yakutsk","Asia/Yangon","Asia/Yekaterinburg","Asia/Yerevan","Atlantic/Azores","Atlantic/Bermuda","Atlantic/Canary","Atlantic/Cape_Verde","Atlantic/Faeroe","Atlantic/Faroe","Atlantic/Jan_Mayen","Atlantic/Madeira","Atlantic/Reykjavik","Atlantic/South_Georgia","Atlantic/St_Helena","Atlantic/Stanley","Australia/ACT","Australia/Adelaide","Australia/Brisbane","Australia/Broken_Hill","Australia/Canberra","Australia/Currie","Australia/Darwin","Australia/Eucla","Australia/Hobart","Australia/LHI","Australia/Lindeman","Australia/Lord_Howe","Australia/Melbourne","Australia/NSW","Australia/North","Australia/Perth","Australia/Queensland","Australia/South","Australia/Sydney","Australia/Tasmania","Australia/Victoria","Australia/West","Australia/Yancowinna","Brazil/Acre","Brazil/DeNoronha","Brazil/East","Brazil/West","CET","CST6CDT","Canada/Atlantic","Canada/Central","Canada/Eastern","Canada/Mountain","Canada/Newfoundland","Canada/Pacific","Canada/Saskatchewan","Canada/Yukon","Chile/Continental","Chile/EasterIsland","Cuba","EET","EST","EST5EDT","Egypt","Eire","Etc/GMT","Etc/GMT+0","Etc/GMT+1","Etc/GMT+10","Etc/GMT+11","Etc/GMT+12","Etc/GMT+2","Etc/GMT+3","Etc/GMT+4","Etc/GMT+5","Etc/GMT+6","Etc/GMT+7","Etc/GMT+8","Etc/GMT+9","Etc/GMT-0","Etc/GMT-1","Etc/GMT-10","Etc/GMT-11","Etc/GMT-12","Etc/GMT-13","Etc/GMT-14","Etc/GMT-2","Etc/GMT-3","Etc/GMT-4","Etc/GMT-5","Etc/GMT-6","Etc/GMT-7","Etc/GMT-8","Etc/GMT-9","Etc/GMT0","Etc/Greenwich","Etc/UCT","Etc/UTC","Etc/Universal","Etc/Zulu","Europe/Amsterdam","Europe/Andorra","Europe/Astrakhan","Europe/Athens","Europe/Belfast","Europe/Belgrade","Europe/Berlin","Europe/Bratislava","Europe/Brussels","Europe/Bucharest","Europe/Budapest","Europe/Busingen","Europe/Chisinau","Europe/Copenhagen","Europe/Dublin","Europe/Gibraltar","Europe/Guernsey","Europe/Helsinki","Europe/Isle_of_Man","Europe/Istanbul","Europe/Jersey","Europe/Kaliningrad","Europe/Kiev","Europe/Kirov","Europe/Kyiv","Europe/Lisbon","Europe/Ljubljana","Europe/London","Europe/Luxembourg","Europe/Madrid","Europe/Malta","Europe/Mariehamn","Europe/Minsk","Europe/Monaco","Europe/Moscow","Europe/Nicosia","Europe/Oslo","Europe/Paris","Europe/Podgorica","Europe/Prague","Europe/Riga","Europe/Rome","Europe/Samara","Europe/San_Marino","Europe/Sarajevo","Europe/Saratov","Europe/Simferopol","Europe/Skopje","Europe/Sofia","Europe/Stockholm","Europe/Tallinn","Europe/Tirane","Europe/Tiraspol","Europe/Ulyanovsk","Europe/Uzhgorod","Europe/Vaduz","Europe/Vatican","Europe/Vienna","Europe/Vilnius","Europe/Volgograd","Europe/Warsaw","Europe/Zagreb","Europe/Zaporozhye","Europe/Zurich","Factory","GB","GB-Eire","GMT","GMT+0","GMT-0","GMT0","Greenwich","HST","Hongkong","Iceland","Indian/Antananarivo","Indian/Chagos","Indian/Christmas","Indian/Cocos","Indian/Comoro","Indian/Kerguelen","Indian/Mahe","Indian/Maldives","Indian/Mauritius","Indian/Mayotte","Indian/Reunion","Iran","Israel","Jamaica","Japan","Kwajalein","Libya","MET","MST","MST7MDT","Mexico/BajaNorte","Mexico/BajaSur","Mexico/General","NZ","NZ-CHAT","Navajo","PRC","PST8PDT","Pacific/Apia","Pacific/Auckland","Pacific/Bougainville","Pacific/Chatham","Pacific/Chuuk","Pacific/Easter","Pacific/Efate","Pacific/Enderbury","Pacific/Fakaofo","Pacific/Fiji","Pacific/Funafuti","Pacific/Galapagos","Pacific/Gambier","Pacific/Guadalcanal","Pacific/Guam","Pacific/Honolulu","Pacific/Johnston","Pacific/Kanton","Pacific/Kiritimati","Pacific/Kosrae","Pacific/Kwajalein","Pacific/Majuro","Pacific/Marquesas","Pacific/Midway","Pacific/Nauru","Pacific/Niue","Pacific/Norfolk","Pacific/Noumea","Pacific/Pago_Pago","Pacific/Palau","Pacific/Pitcairn","Pacific/Pohnpei","Pacific/Ponape","Pacific/Port_Moresby","Pacific/Rarotonga","Pacific/Saipan","Pacific/Samoa","Pacific/Tahiti","Pacific/Tarawa","Pacific/Tongatapu","Pacific/Truk","Pacific/Wake","Pacific/Wallis","Pacific/Yap","Poland","Portugal","ROC","ROK","Singapore","Turkey","UCT","US/Alaska","US/Aleutian","US/Arizona","US/Central","US/East-Indiana","US/Eastern","US/Hawaii","US/Indiana-Starke","US/Michigan","US/Mountain","US/Pacific","US/Samoa","UTC","Universal","W-SU","WET","Zulu"],"minLength":1,"title":"Eventtimezone","description":"The event timezone"},"currency":{"type":"string","enum":["AED","AFN","ALL","AMD","ANG","AOA","ARS","AUD","AWG","AZN","BAM","BBD","BDT","BGN","BHD","BIF","BMD","BND","BOB","BOV","BRL","BSD","BTN","BWP","BYN","BZD","CAD","CDF","CHE","CHF","CHW","CLF","CLP","CNY","COP","COU","CRC","CUC","CUP","CVE","CZK","DJF","DKK","DOP","DZD","EGP","ERN","ETB","EUR","FJD","FKP","GBP","GEL","GHS","GIP","GMD","GNF","GTQ","GYD","HKD","HNL","HRK","HTG","HUF","IDR","ILS","INR","IQD","IRR","ISK","JMD","JOD","JPY","KES","KGS","KHR","KMF","KPW","KRW","KWD","KYD","KZT","LAK","LBP","LKR","LRD","LSL","LYD","MAD","MDL","MGA","MKD","MMK","MNT","MOP","MRU","MUR","MVR","MWK","MXN","MXV","MYR","MZN","NAD","NGN","NIO","NOK","NPR","NZD","OMR","PAB","PEN","PGK","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","RWF","SAR","SBD","SCR","SDG","SEK","SGD","SHP","SLE","SLL","SOS","SRD","SSP","STN","SVC","SYP","SZL","THB","TJS","TMT","TND","TOP","TRY","TTD","TWD","TZS","UAH","UGX","USD","USN","UYI","UYU","UYW","UZS","VED","VES","VND","VUV","WST","XAF","XCD","XOF","XPF","XSU","XUA","YER","ZAR","ZMW","ZWL"],"maxLength":3,"minLength":3,"title":"Currency","description":"The event currency"},"sessionCount":{"type":"integer","title":"Sessioncount","description":"Total number of sessions of the event"},"firstSessionStartAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Firstsessionstartat","description":"Start date of the earliest session (Event timezone). Null when the event has no sessions"},"lastSessionStartAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lastsessionstartat","description":"Start date of the latest session (Event timezone). Null when the event has no sessions"},"nextSessionStartAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nextsessionstartat","description":"Start date of the next upcoming session (Event timezone). Null when no session is upcoming"},"nextSessionId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nextsessionid","description":"Identifier of the next upcoming session. Null when no session is upcoming"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","description":"The event tags (display labels)"}},"type":"object","required":["id","createdAt","updatedAt","title","description","imageUrl","venueName","venueAddress","eventTimezone","currency","sessionCount","firstSessionStartAt","lastSessionStartAt","nextSessionStartAt","nextSessionId","tags"],"title":"EventApiResponse","description":"Event shape: flat session summary fields only; sessions are enumerated via\nGET /events/{event_id}/sessions."},"EventSessionApiResponse":{"properties":{"id":{"type":"string","title":"Id","description":"The event session identifier"},"startAt":{"type":"string","title":"Startat","description":"The event session start date (Event timezone)"},"durationMinutes":{"type":"integer","title":"Durationminutes","description":"The event session duration in minutes"}},"type":"object","required":["id","startAt","durationMinutes"],"title":"EventSessionApiResponse"},"FormFieldResponseApiResponse":{"properties":{"fieldId":{"type":"string","title":"Fieldid","description":"Identifier of the form field, as configured by the organizer"},"value":{"items":{"type":"string"},"type":"array","title":"Value","description":"The submitted value(s). Always an array, even for single values."}},"type":"object","required":["fieldId","value"],"title":"FormFieldResponseApiResponse"},"FormResponseApiResponse":{"properties":{"formId":{"type":"string","title":"Formid","description":"Versioned identifier of the form definition"},"submittedAt":{"type":"string","title":"Submittedat","description":"UTC timestamp of when the form was submitted (ISO 8601)"},"responses":{"items":{"$ref":"#/components/schemas/FormFieldResponseApiResponse"},"type":"array","title":"Responses","description":"List of form field responses"}},"type":"object","required":["formId","submittedAt","responses"],"title":"FormResponseApiResponse"},"HTTPErrorResponse":{"properties":{"detail":{"type":"string","title":"Detail"}},"type":"object","required":["detail"],"title":"HTTPErrorResponse","description":"Standard structure for HTTP error responses (similar to FastAPI's HTTPException).\n\nWe use this model for validation."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"OptInApiResponse":{"properties":{"name":{"type":"string","title":"Name","description":"The opt-in display name"},"accepted":{"type":"boolean","title":"Accepted","description":"Whether the customer accepted this opt-in"}},"type":"object","required":["name","accepted"],"title":"OptInApiResponse"},"OrderAddOnApiResponse":{"properties":{"category":{"type":"string","enum":["INSURANCE","DONATION"],"title":"Category","description":"The add-on category (INSURANCE or DONATION)"},"serviceId":{"type":"string","title":"Serviceid","description":"Identifier of the underlying service. For INSURANCE: the insurance provider id. For DONATION: the donation provider id."},"serviceName":{"type":"string","title":"Servicename","description":"Display name of the add-on. For INSURANCE: the provider name (e.g. 'Neat'). For DONATION: the charity name (e.g. 'Common Cents')."},"addOnPaidPrice":{"type":"number","title":"Addonpaidprice","description":"Amount paid for this add-on"}},"type":"object","required":["category","serviceId","serviceName","addOnPaidPrice"],"title":"OrderAddOnApiResponse"},"OrderApiResponse":{"properties":{"orderId":{"type":"string","title":"Orderid","description":"The order identifier"},"orderNumber":{"type":"string","title":"Ordernumber","description":"The order number"},"basketId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Basketid","description":"The identifier of the basket the order originated from. Null for orders not created through the Billy checkout."},"salesChannelId":{"type":"string","title":"Saleschannelid","description":"The sales channel identifier"},"salesChannelName":{"type":"string","title":"Saleschannelname","description":"The sales channel name"},"status":{"type":"string","title":"Status","description":"The order status (PENDING, FULFILLED, CANCELLED)"},"customer":{"$ref":"#/components/schemas/CustomerApiResponse","description":"The customer information"},"billingAddress":{"anyOf":[{"$ref":"#/components/schemas/AddressApiResponse"},{"type":"null"}],"description":"The billing address used for the order"},"currency":{"type":"string","enum":["AED","AFN","ALL","AMD","ANG","AOA","ARS","AUD","AWG","AZN","BAM","BBD","BDT","BGN","BHD","BIF","BMD","BND","BOB","BOV","BRL","BSD","BTN","BWP","BYN","BZD","CAD","CDF","CHE","CHF","CHW","CLF","CLP","CNY","COP","COU","CRC","CUC","CUP","CVE","CZK","DJF","DKK","DOP","DZD","EGP","ERN","ETB","EUR","FJD","FKP","GBP","GEL","GHS","GIP","GMD","GNF","GTQ","GYD","HKD","HNL","HRK","HTG","HUF","IDR","ILS","INR","IQD","IRR","ISK","JMD","JOD","JPY","KES","KGS","KHR","KMF","KPW","KRW","KWD","KYD","KZT","LAK","LBP","LKR","LRD","LSL","LYD","MAD","MDL","MGA","MKD","MMK","MNT","MOP","MRU","MUR","MVR","MWK","MXN","MXV","MYR","MZN","NAD","NGN","NIO","NOK","NPR","NZD","OMR","PAB","PEN","PGK","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","RWF","SAR","SBD","SCR","SDG","SEK","SGD","SHP","SLE","SLL","SOS","SRD","SSP","STN","SVC","SYP","SZL","THB","TJS","TMT","TND","TOP","TRY","TTD","TWD","TZS","UAH","UGX","USD","USN","UYI","UYU","UYW","UZS","VED","VES","VND","VUV","WST","XAF","XCD","XOF","XPF","XSU","XUA","YER","ZAR","ZMW","ZWL"],"maxLength":3,"minLength":3,"title":"Currency","description":"The currency code (ISO 4217)"},"totalPrice":{"type":"number","title":"Totalprice","description":"The total price of the order including fees"},"totalPaidPrice":{"type":"number","title":"Totalpaidprice","description":"The total price actually paid by the customer"},"subtotalPrice":{"type":"number","title":"Subtotalprice","description":"The total price of the order excluding fees"},"subtotalPaidPrice":{"type":"number","title":"Subtotalpaidprice","description":"The subtotal price actually paid by the customer"},"discountAmount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Discountamount","description":"The total discount amount applied to the order. Null if no discount was applied."},"discountCode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Discountcode","description":"The discount code applied to the order"},"paymentProvider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Paymentprovider","description":"The payment provider (Boomfi, Stripe). Null if no payment yet."},"paymentMethod":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Paymentmethod","description":"The payment method (VISA, MASTERCARD...). Null if no payment yet."},"serviceFees":{"type":"number","title":"Servicefees","description":"The service fees charged"},"deliveryFees":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Deliveryfees","description":"The delivery fees charged. Null if no delivery."},"totalVatAmount":{"type":"number","title":"Totalvatamount","description":"The total VAT amount"},"delivery":{"anyOf":[{"$ref":"#/components/schemas/DeliveryApiResponse"},{"type":"null"}],"description":"The delivery information"},"placedItems":{"items":{"$ref":"#/components/schemas/OrderItemApiResponse"},"type":"array","title":"Placeditems","description":"The list of ordered items. Bundle items are unpacked into individual line items."},"optIns":{"items":{"$ref":"#/components/schemas/OptInApiResponse"},"type":"array","title":"Optins","description":"The opt-ins recorded for the order"},"createdAt":{"type":"string","title":"Createdat","description":"The order creation date (UTC)"},"fulfilledAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fulfilledat","description":"The order fulfillment date (UTC). Null if not yet fulfilled."},"cancelledAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cancelledat","description":"The order cancellation date (UTC). Null if not cancelled."},"updatedAt":{"type":"string","title":"Updatedat","description":"The order last update date (UTC)"},"paymentStatus":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Paymentstatus","description":"The payment status (PAID, REFUNDED, PARTIALLY_REFUNDED). Null if no payment has been completed yet."},"refundedAmount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Refundedamount","description":"The total refunded amount across all refunds"},"addOns":{"items":{"$ref":"#/components/schemas/OrderAddOnApiResponse"},"type":"array","title":"Addons","description":"Add-ons (insurance / donations) attached to the order. Empty if none."},"ticketsProtected":{"type":"boolean","title":"Ticketsprotected","description":"True if the order contains an active INSURANCE add-on.","default":false}},"type":"object","required":["orderId","orderNumber","salesChannelId","salesChannelName","status","customer","currency","totalPrice","totalPaidPrice","subtotalPrice","subtotalPaidPrice","serviceFees","totalVatAmount","placedItems","optIns","createdAt","updatedAt"],"title":"OrderApiResponse"},"OrderItemApiResponse":{"properties":{"offerId":{"type":"string","title":"Offerid","description":"The offer identifier"},"offerName":{"type":"string","title":"Offername","description":"The offer name"},"inventoryId":{"type":"string","title":"Inventoryid","description":"The inventory identifier"},"quantity":{"type":"integer","title":"Quantity","description":"The number of units ordered for this item"},"unitPrice":{"type":"number","title":"Unitprice","description":"The initial unit price of the item"},"unitPaidPrice":{"type":"number","title":"Unitpaidprice","description":"The unit price of the item which was actually paid"},"unitDiscountAmount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Unitdiscountamount","description":"The per-unit discount amount applied to the item"},"discountCode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Discountcode","description":"The discount code applied to the item"},"priceLabel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pricelabel","description":"The pricing plan label"},"offerType":{"type":"string","title":"Offertype","description":"The offer type (TICKET or PRODUCT)"},"eventId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Eventid","description":"The event the offer belongs to."},"sessionId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sessionid","description":"The ticket offer session id"},"unitVatAmount":{"type":"number","title":"Unitvatamount","description":"The per-unit VAT amount"}},"type":"object","required":["offerId","offerName","inventoryId","quantity","unitPrice","unitPaidPrice","offerType","unitVatAmount"],"title":"OrderItemApiResponse"},"PickupPointApiResponse":{"properties":{"pickupPointId":{"type":"string","title":"Pickuppointid"},"pickupPointName":{"type":"string","title":"Pickuppointname"},"pickupPointAddress":{"$ref":"#/components/schemas/AddressApiResponse"}},"type":"object","required":["pickupPointId","pickupPointName","pickupPointAddress"],"title":"PickupPointApiResponse"},"SeatingInfoApiResponse":{"properties":{"blocName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Blocname","description":"The bloc name"},"seatRow":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seatrow","description":"The seat row"},"seatNumber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seatnumber","description":"The seat number"}},"type":"object","title":"SeatingInfoApiResponse"},"TicketApiResponse":{"properties":{"ticketId":{"type":"string","title":"Ticketid","description":"The ticket identifier"},"eventId":{"type":"string","title":"Eventid","description":"The event identifier"},"invoiceReference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoicereference","description":"The invoice reference"},"status":{"type":"string","title":"Status","description":"The ticket status: VALID or VOIDED"},"offerId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Offerid","description":"The offer identifier"},"offerName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Offername","description":"The offer name"},"issuedAt":{"type":"string","title":"Issuedat","description":"The ticket issuance date (UTC)"},"updatedAt":{"type":"string","title":"Updatedat","description":"The ticket last update date (UTC)"},"cancelledAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cancelledat","description":"The ticket cancellation date (UTC)"},"eventSessionId":{"type":"string","title":"Eventsessionid","description":"The event session identifier"},"eventSessionStartAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Eventsessionstartat","description":"The event session start date (Event timezone)"},"seatingInfo":{"anyOf":[{"$ref":"#/components/schemas/SeatingInfoApiResponse"},{"type":"null"}],"description":"The seating information"},"qrCode":{"type":"string","title":"Qrcode","description":"The ticket QR code"},"issuanceChannel":{"type":"string","title":"Issuancechannel","description":"The issuance channel"},"salesChannelName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Saleschannelname","description":"The sales channel name"},"salesChannelId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Saleschannelid","description":"The sales channel identifier"},"orderId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Orderid","description":"The order identifier"},"orderNumber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ordernumber","description":"The order number"},"pricingId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pricingid","description":"The pricing identifier"},"priceLabel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pricelabel","description":"The price label"},"listPrice":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Listprice","description":"The list price"},"finalPaidPrice":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Finalpaidprice","description":"The final price paid"},"vat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Vat","description":"The VAT amount"},"currency":{"anyOf":[{"type":"string","enum":["AED","AFN","ALL","AMD","ANG","AOA","ARS","AUD","AWG","AZN","BAM","BBD","BDT","BGN","BHD","BIF","BMD","BND","BOB","BOV","BRL","BSD","BTN","BWP","BYN","BZD","CAD","CDF","CHE","CHF","CHW","CLF","CLP","CNY","COP","COU","CRC","CUC","CUP","CVE","CZK","DJF","DKK","DOP","DZD","EGP","ERN","ETB","EUR","FJD","FKP","GBP","GEL","GHS","GIP","GMD","GNF","GTQ","GYD","HKD","HNL","HRK","HTG","HUF","IDR","ILS","INR","IQD","IRR","ISK","JMD","JOD","JPY","KES","KGS","KHR","KMF","KPW","KRW","KWD","KYD","KZT","LAK","LBP","LKR","LRD","LSL","LYD","MAD","MDL","MGA","MKD","MMK","MNT","MOP","MRU","MUR","MVR","MWK","MXN","MXV","MYR","MZN","NAD","NGN","NIO","NOK","NPR","NZD","OMR","PAB","PEN","PGK","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","RWF","SAR","SBD","SCR","SDG","SEK","SGD","SHP","SLE","SLL","SOS","SRD","SSP","STN","SVC","SYP","SZL","THB","TJS","TMT","TND","TOP","TRY","TTD","TWD","TZS","UAH","UGX","USD","USN","UYI","UYU","UYW","UZS","VED","VES","VND","VUV","WST","XAF","XCD","XOF","XPF","XSU","XUA","YER","ZAR","ZMW","ZWL"],"maxLength":3,"minLength":3},{"type":"null"}],"title":"Currency","description":"The price currency (ISO 4217)"},"customer":{"anyOf":[{"$ref":"#/components/schemas/CustomerApiResponse"},{"type":"null"}],"description":"The customer information"},"transferable":{"type":"boolean","title":"Transferable","description":"Whether this ticket can change holder right now, through `POST /tickets/{ticketId}/transfer`. True only when resale is enabled on the ticket's pricing, the ticket is valid, its code has never been scanned, and its session has not started."},"attendeeForm":{"anyOf":[{"$ref":"#/components/schemas/FormResponseApiResponse"},{"type":"null"}],"description":"Attendee information submitted through the registration form. Contains the versioned form identifier, the submission timestamp, and the list of field responses (each with the field identifier as configured by the organizer and the submitted value(s) — always returned as a list of strings). Null if no attendee form was submitted for this ticket."}},"type":"object","required":["ticketId","eventId","status","issuedAt","updatedAt","eventSessionId","qrCode","issuanceChannel","transferable"],"title":"TicketApiResponse","description":"The stable ticket."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VenueAddressApiResponse":{"properties":{"addressLine1":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Addressline1","description":"Street address line 1"},"addressLine2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Addressline2","description":"Street address line 2 (complement)"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"City / locality"},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postalcode","description":"Postal code"},"countryCode":{"anyOf":[{"type":"string","pattern":"^\\w{2}$"},{"type":"null"}],"title":"Countrycode","description":"ISO 3166-1 alpha-2 country code"}},"type":"object","required":["addressLine1","addressLine2","city","postalCode","countryCode"],"title":"VenueAddressApiResponse"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer","bearerFormat":"billy:o:<organization_id>:<api_key>","description":"API key authentication. Format: `Bearer billy:o:<organization_id>:<api_key>`\n\nExample: `Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx`"}}}}