Skip to content
Docs
Operation

List channel listings

GET/sales-channels/{channelId}/listings
List the events listed on the channel

Path parameters

channelIdstringRequired

Returns

Listings retrieved 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 GET "https://api.ticketlayer.com/v1/sales-channels/{channelId}/listings" \  -H "Authorization: Bearer tlak_..." \  -H "X-Ticketlayer-Org: your-org-slug"
Response 200
{
  "listings": [
    {
      "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": [
            {}
          ]
        },
        "visible": {
          "open": true,
          "windows": [
            {}
          ]
        },
        "sellable": {
          "open": true,
          "windows": [
            {}
          ]
        }
      },
      "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