Sign in

v11

latestOpenAPI 3.1.12026-08-03174162.0 MB
Tickets

List tickets with cursor-based pagination

Returns ticket data with cursor-based pagination, optional full-text search via query, and a fixed attendee-name ascending order for non-search list paths.

get/tickets

Query parameters

promoterIdstring

Filter tickets by promoter/organizer unique identifier (optional)

Example:pmt_01jqpjksnsen9vprw95et60t2m
eventIdstring

Filter tickets by event unique identifier (optional)

Example:evt_01jps5cgsenjrazw6wswmyspa3
customerIdstring

Filter tickets by customer unique identifier (optional)

Example:cus_01jps5cgsf4pn2a32eamppnap1
orderIdstring

Filter tickets by order unique identifier (optional)

Example:ord_01jps5cgsfgve5b5g2666kyryh
status'ACTIVE' | 'REDEEMED' | 'CANCELLED'

Filter tickets by status: ACTIVE (can be used), REDEEMED (already used), CANCELLED (invalidated or refunded)

Example:ACTIVE
orderSignaturestring

Order signature used to access tickets for a specific order without permissions (16 characters, base64url encoded)

querystring

Optional search query to filter tickets by customer details. When provided, search-backed pagination is used.

Example:John Doe
limitinteger

Maximum number of tickets to return per request (1-100, default: 20)

Example:20
cursorstring

Pagination cursor for continuing to fetch subsequent results (optional)

Example:eyJpZCI6InRrdF8wMWpwczVjZ3NnMHMzMncycHI3M3ZiY2NkZSJ9

Response

OK

beforestring nullable

Cursor for navigating backward in the result set. Omitted when there are no prior results.

afterstring nullable

Cursor for navigating forward in the result set. Omitted when there are no subsequent results.

limitnumber required

Maximum number of items to return in each result set

Example response

{
  "tickets": [
    {
      "id": "tkt_01jps5cgsg0s32w2pr73vbccde",
      "createdAt": "2026-08-03T06:13:52.220Z",
      "updatedAt": "2026-08-03T06:13:52.220Z",
      "scans": [
        {
          "id": "scn_01jq4rjmtzyzgtsavn9f34mxan",
          "scannedAt": "2026-08-03T06:13:52.219Z",
          "scannedById": "usr_01jps5cgsd4tzjghtnt45qnhn0",
          "scannedBy": {
            "id": "usr_01jps5cgsd4tzjghtnt45qnhn0",
            "firstName": "Jay",
            "lastName": "McMullen",
            "email": "test@session.services"
          },
          "deviceId": "dev_01jq4rjvrgar43zwvyakbje22m",
          "kind": "CHECK_IN"
        }
      ],
      "status": "ACTIVE",
      "attendee": {
        "firstName": "Test",
        "lastName": "User",
        "email": "test@session.services",
        "phone": "+61411111111"
      },
      "customerId": "cus_01jps5cgsf4pn2a32eamppnap1",
      "eventId": "evt_01jps5cgsenjrazw6wswmyspa3",
      "event": {
        "id": "evt_01jps5cgsenjrazw6wswmyspa3",
        "name": "Test Event",
        "slug": "test-event",
        "location": {
          "id": "loc_01hk153x00eh99pagyydz03sbz",
          "googlePlaceId": "ChIJP3Sa8ziYEmsRUKgyFmh9AQM",
          "createdAt": "2026-08-03T06:13:52.214Z",
          "updatedAt": "2026-08-03T06:13:52.214Z",
          "name": "Watson's EQ",
          "address": "The, Entertainment Quarter, 1 Bent St, Moore Park NSW 2021, Australia",
          "city": "Moore Park",
          "state": "New South Wales",
          "postcode": "2021",
          "country": "Australia",
          "latitude": -33.8944593,
          "longitude": 151.2252255,
          "timeZone": "Australia/Sydney",
          "types": [
            "establishment",
            "point_of_interest",
            "stadium"
          ],
          "description": "Historic outdoor amphitheater known for summer concerts",
          "image": {
            "src": "https://assets.session.services/my-image.jpg",
            "alt": "My Image",
            "width": 1080,
            "height": 1080
          }
        },
        "entryStartsAt": "2026-08-04T06:13:52",
        "entryEndsAt": "2026-08-05T06:13:52",
        "images": {
          "mobile": {
            "src": "https://assets.session.services/my-image.jpg",
            "alt": "My Image",
            "width": 1080,
            "height": 1080
          },
          "desktop": {
            "src": "https://assets.session.services/my-image.jpg",
            "alt": "My Image",
            "width": 1080,
            "height": 1080
          }
        }
      },
      "admissionId": "adm_01jps5cgsee0xvapbk92e8eb4g",
      "admission": {
        "id": "adm_01jps5cgsee0xvapbk92e8eb4g",
        "name": "VIP Access",
        "price": {
          "currency": "USD"
        },
        "entryStartsAt": "2025-03-15T19:30:00",
        "entryEndsAt": "2025-03-15T19:30:00"
      },
      "section": {
        "id": "sct_01jps5cgse0g3qj16kpq8t221r",
        "name": "Floor Section A",
        "location": {
          "timeZone": "America/New_York"
        }
      },
      "orderId": "ord_01jps5cgsfgve5b5g2666kyryh",
      "orderItemId": "itm_01jps5cgsfwyxj0516571eaf17",
      "teamId": "tem_01jqpjksnsen9vprw95et60t2m",
      "promoterId": "pmt_01jqpjksnsen9vprw95et60t2m"
    }
  ],
  "before": "eyJ2ZXJzaW9uIjoxLCJpbnRlbnQiOnsic291cmNlIjoiZGVtbyJ9LCJwb3MiOnsicHJpbWFyeUtleSI6InBybV8wMXM4NTNqIn19",
  "after": "eyJ2ZXJzaW9uIjoxLCJpbnRlbnQiOnsic291cmNlIjoiZGVtbyJ9LCJwb3MiOnsicHJpbWFyeUtleSI6InBybV8wMXM4NTNkIn19",
  "limit": 20
}