v11

latestOpenAPI 3.1.12026-08-03174162.0 MB

Tickets

Create a new ticket

post/tickets

Request body

status'ACTIVE' | 'REDEEMED' | 'CANCELLED' required

Current status of the ticket: ACTIVE (can be used), REDEEMED (already used), CANCELLED (invalidated or refunded)

admissionIdstring required

Unique identifier of the admission type/tier this ticket represents

orderItemIdstring

Unique identifier of the specific order item this ticket represents

orderIdstring required

The order this ticket belongs to

customerIdstring required

The customer who purchased this ticket

Example request

{
  "status": "ACTIVE",
  "admissionId": "adm_01jps5cgsee0xvapbk92e8eb4g",
  "orderItemId": "itm_01jps5cgsfwyxj0516571eaf17",
  "orderId": "ord_01jps5cgsfgve5b5g2666kyryh",
  "customerId": "cus_01jps5cgsf4pn2a32eamppnap1",
  "attendee": {
    "firstName": "Test",
    "lastName": "User",
    "email": "test@session.services",
    "phone": "+61411111111"
  }
}

Response

Example response

{
  "ticket": {
    "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"
  }
}