List sales channels
Retrieves a paginated list of the sales channels of your organization's events, oldest first, each as GET /v1/sales-channels/{salesChannelId} returns it. Pass eventId to list the channels of one event.
Preview release
preview release target — send Billy-API-Version: preview to reach it. Preview has no stability promise: its routes and payloads can change without notice, so pin a dated release before you depend on one.Retrieves a paginated list of the sales channels of your organization's events, oldest first, each as GET /v1/sales-channels/{salesChannelId} returns it. Pass eventId to list the channels of one event.
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
Only the channels selling this event
Header Parameters
Requested API version. Current context: preview.
"preview"Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/sales-channels" \ -H "Billy-API-Version: preview"{ "items": [ { "id": "5ad8d09e-c789-49e6-a8f8-1434f880beeb", "name": "Partner X", "title": "Jazz Night — tickets", "status": "DRAFT", "openingDate": "2026-11-01T10:00:00+01:00", "closingDate": "2026-12-01T23:00:00+01:00", "customerFormId": "frm_01ABCDEFGHIJKLMN", "optIns": [ { "id": "newsletter", "name": "Newsletter", "mandatory": false, "displayValues": { "fr": "Recevoir la newsletter" } } ], "offers": [ { "offerId": "331704d8-50bf-4e99-8d82-95c4974b1a2b", "type": "TICKET", "name": "Pass 2 jours", "description": "<p>Accès aux deux journées</p>", "eventId": "168c36ec-2e28-4312-be93-8893f0cc4d5e", "currency": "EUR", "images": [], "tags": [ "pass" ], "minQuantityPerOrder": 1, "maxQuantityPerOrder": 10, "compareAtPrice": 55, "createdAt": "2026-08-01T10:00:00+00:00", "vatRate": 0.2, "defaultMaximumCapacity": 500, "attendeeFormId": "5d6e7f80-9a0b-4c1d-8e2f-3a4b5c6d7e8f", "pricing": [ { "pricingId": "9f2c1b44-77aa-4f10-9c3e-0d1b2e3f4a5b", "name": "Tarif plein", "price": 45, "bundleOfferId": null, "resaleEnabled": true }, { "pricingId": "b3e7d901-1c22-4a55-8f6d-7e8f9a0b1c2d", "name": "Tarif étudiant", "price": 32, "bundleOfferId": null, "resaleEnabled": false }, { "pricingId": "c4f8ea12-2d33-4b66-9a7e-8f9a0b1c2d3e", "name": "Pass festival 3 dates", "price": 36, "bundleOfferId": "7a1b2c3d-4e5f-4061-8172-93a4b5c6d7e8", "resaleEnabled": true } ], "optionOffers": [ { "offerId": "4c5d6e7f-8091-4a2b-b3c4-d5e6f7a8b9c0", "pricingId": "5e6f7a8b-9c0d-4e1f-a2b3-c4d5e6f7a8b9", "minQuantityPerBase": 0, "maxQuantityPerBase": 2 } ], "extras": [ { "offerId": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d", "minQuantityPerTicket": 0, "maxQuantityPerTicket": 3 } ], "minDistinctExtrasPerTicket": 0, "maxDistinctExtrasPerTicket": null, "inventory": [ { "inventoryId": "e1f2a3b4-c5d6-4e7f-8091-a2b3c4d5e6f7", "sessionId": "11223344-5566-4778-899a-bbccddeeff00", "totalStock": 500, "availableStock": 412 } ] } ], "createdAt": "2026-10-27T09:12:44.512000+00:00" } ], "page": 1, "perPage": 10, "totalPages": 1, "hasMore": false, "nextPage": null}