Skip to content
Docs
Open Backstage
Operation

List event on channel

POST/sales-channels/{channelId}/listings
List an event on the channel. An event is never published globally - it is listed on channels. The listing inherits the event's three rules (discoverable, visible, sellable) unless `rules` overrides one for this channel; a null or omitted rule inherits.

Path parameters

channelIdstringRequired

Headers

Idempotency-KeystringOptional
Makes the write safe to retry. The first request with a key does the work and its response is stored for 24 hours; a repeat with the same key and the same request (method, path, query, X-Ticketlayer-Channel, TL-Version and body) gets that stored status and body back, marked `Idempotent-Replay: true`, without running again. The key is scoped to your organisation and your credential. The same key with a different request is 422 IDEMPOTENCY_KEY_REUSED; a repeat while the first is still running waits for it, then answers 409 IDEMPOTENT_REQUEST_IN_PROGRESS if it has not finished. Only a 2xx is stored: after an error the key is free again. Omit the header and the request behaves as it always has.

Body

eventId*string
▼rulesobject
discoverableany
visibleany
sellableany

Returns

Listing created successfully

Errors

400
Bad Request - Invalid input
401
Unauthorized - Authentication required
403
Forbidden - Insufficient permissions
404
Not Found - Resource not found
500
Internal Server Error

Every error names its code and links to it. All error codes

curl -X POST "https://api.ticketlayer.com/v1/sales-channels/{channelId}/listings" \  -H "Authorization: Bearer tlak_..." \  -H "X-Ticketlayer-Org: your-org-slug" \  -H "Content-Type: application/json" \  -d '{    "eventId": "string",    "rules": {      "discoverable": {        "open": true,        "windows": [          {            "from": null,            "until": null,            "audienceTags": [              "member.priority-booking"            ],            "audience": null          }        ]      },      "visible": {        "open": true,        "windows": [          {            "from": null,            "until": null,            "audienceTags": [              "member.priority-booking"            ],            "audience": null          }        ]      },      "sellable": {        "open": true,        "windows": [          {            "from": null,            "until": null,            "audienceTags": [              "member.priority-booking"            ],            "audience": null          }        ]      }    }  }'
Response 201
{
  "listing": {
    "id": "schl_abc123",
    "channelId": "sch_abc123",
    "eventId": "evt_abc123",
    "rules": {
      "discoverable": {
        "open": true,
        "windows": [
          {}
        ]
      },
      "visible": {
        "open": true,
        "windows": [
          {}
        ]
      },
      "sellable": {
        "open": true,
        "windows": [
          {}
        ]
      }
    },
    "effective": {
      "discoverable": {
        "open": true,
        "windows": [
          {
            "from": null,
            "until": null,
            "audienceTags": [],
            "audience": null
          }
        ]
      },
      "visible": {
        "open": true,
        "windows": [
          {
            "from": null,
            "until": null,
            "audienceTags": [],
            "audience": null
          }
        ]
      },
      "sellable": {
        "open": true,
        "windows": [
          {
            "from": null,
            "until": null,
            "audienceTags": [],
            "audience": null
          }
        ]
      }
    },
    "state": {
      "discoverable": true,
      "visible": true,
      "sellable": true,
      "opensAt": null,
      "closesAt": null
    },
    "createdAt": "2026-01-15T10:30:00Z",
    "updatedAt": "2026-01-15T10:30:00Z"
  }
}

Try it in test mode

Path parameters
Body