Retrieve a sales channel
Retrieves a single sales channel: when it sells, its offers as the catalog describes them — each holding only the pricings and the session stock lines it is sold at on this channel — the opt-ins and the customer form its buyers fill in. How Billy's own shop draws the channel is not part of it. Returns 404 when the channel does not exist or sells an event of another organization.
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 single sales channel: when it sells, its offers as the catalog describes them — each holding only the pricings and the session stock lines it is sold at on this channel — the opt-ins and the customer form its buyers fill in. How Billy's own shop draws the channel is not part of it. Returns 404 when the channel does not exist or sells an event of another organization.
Authorization
HTTPBearer API key authentication. Format: Bearer billy:o:<organization_id>:<api_key>
Example: Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx
In: header
Path Parameters
Header Parameters
Requested API version. Current context: preview.
"preview"Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/sales-channels/string" \ -H "Billy-API-Version: preview"{ "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"}