Guest Purchases

Create Guest Purchase

post

https://api-demo.tonicticketing.com/v1https://api.tonicticketing.com/v1https://api-qa.tonicticketing.com/v1

/events/{event}/guests

Creates a guest purchase for the specified event.

Authorizations

bearerAuth

AuthorizationstringRequired

OAuth2 Bearer token authentication. Requires event contribute permissions.

See Tonic Authentication Documentation for details on obtaining tokens.

Path parameters

eventstringRequired

Event ID

Example: 60001c4569308525d873cbd7Pattern: ^[a-f0-9]{24}$

Header parameters

authorizationstringRequired

Contains bearer followed by bearer token

Body

application/json

occurrencestringRequired

Event occurrence date in YYYYMMDD format

Example: 20251225Pattern: ^\d{8}$

sourcestringOptional

Purchase source identifier. Should be set to partner

Example: designmynight-ticket-scanner

partner_sourcestring · max: 255Optional

Optional field identifying the third-party channel. This field is independent of the source field and is used for tracking purposes.

Example: ThirdParty

Responses

200

Guest purchase created successfully

application/json

401

Authentication required or invalid token

application/json

403

Insufficient permissions

application/json

404

Resource not found

application/json

422

Validation failed

application/json

post

/events/{event}/guests

HTTPcURLJavaScriptPython

POST /v1/events/{event}/guests HTTP/1.1
Host: api-demo.tonicticketing.com
Authorization: Bearer YOUR_SECRET_TOKEN
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 372

{
  "occurrence": "20251225",
  "source": "partner",
  "partner_source": "Third Party",
  "details": {
    "ticket_type": "60001c2b69308526373f96ae",
    "email": "[email protected]",
    "phone": "442012345678",
    "first_name": "John",
    "last_name": "Smith",
    "quantity": 2,
    "unit_price": 2550,
    "partner_commission": 250,
    "currency": "GBP",
    "comments": "VIP guest - backstage pass required",
    "other_guests": [
      "Jane Doe"
    ]
  }
}

{
  "data": {
    "_id": "507f1f77bcf86cd799439011",
    "email": "[email protected]",
    "phone": 123456789,
    "item_id": "507f1f77bcf86cd799439012",
    "currency": "GBP",
    "status": "external",
    "source": "partner",
    "partner_source": null,
    "rep_id": null,
    "tracking_id": null,
    "affiliate_id": null,
    "user_id": "507f1f77bcf86cd799439013",
    "item_date": "2025-12-25 00:00:00",
    "completed_date": "2025-12-24 15:17:34",
    "payments": [],
    "total_cost": 0,
    "purchase_id": 363633888,
    "address": {
      "first_name": "John",
      "last_name": "Smith"
    },
    "comments": "VIP guest - requires wheelchair access",
    "organisation_id": "507f1f77bcf86cd799439014",
    "event_brand_id": "507f1f77bcf86cd799439015",
    "venue_id": null,
    "last_updated": "2025-12-24 15:17:34",
    "created_date": "2025-12-24 15:17:34",
    "item": {},
    "checkout_questions": [],
    "reservation_details": null,
    "refund_request": [],
    "items": [
      {
        "_id": "507f1f77bcf86cd799439016",
        "purchase_item_type": "ticket",
        "name": "Christmas Concert",
        "sub_type": "507f1f77bcf86cd799439017",
        "sub_type_name": "General Admission",
        "quantity": 2,
        "admin_fee": 0,
        "multi_day_ticket": false,
        "ticket_list": [
          {
            "_id": "507f1f77bcf86cd799439018",
            "reference": 275,
            "checked_in": null,
            "guest_name": "John Smith"
          },
          {
            "_id": "507f1f77bcf86cd799439019",
            "reference": 100,
            "checked_in": null,
            "guest_name": "Jane Doe"
          }
        ]
      }
    ]
  }
}