Get Ticket Sales Buckets

Valid ticket counts per time bucket (for a sales chart), plus per-bucket totals and partner-credit (kickback) attribution. Provide ordered, non-overlapping time buckets; omit event_id for account-wide.

Authorization

AuthorizationRequiredBearer <token>

API key as Bearer token

In: header

Request Body

application/jsonRequired

event_idstring

Scope to one event; omit for account-wide

bucketsRequiredarray<object>

Ordered, non-overlapping time buckets (max 1000)

POST/v1/tickets/sales-buckets

curl -X POST "https://api.3common.com/v1/tickets/sales-buckets" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "event_id": "string",
    "buckets": [
      {
        "startMs": 0,
        "endMs": 0,
        "label": "string"
      }
    ]
  }'

Default Response

Response

{
  "data": {
    "sum": 0,
    "partner_credit": 0,
    "data": [
      0
    ],
    "labels": [
      "string"
    ],
    "tickets": {
      "validTickets": 0,
      "invalidTickets": 0,
      "refundedTickets": 0,
      "deletedTickets": 0,
      "totalTickets": 0
    }
  }
}

TypeScript

export interface Response {
  data: {
    /**
     * Total valid tickets across all buckets
     */
    sum: number;
    /**
     * Kickback attributed to the event, in cents
     */
    partner_credit?: number;
    /**
     * Valid ticket count per bucket
     */
    data: number[];
    labels: string[];
    tickets?: {
      validTickets: number;
      invalidTickets: number;
      refundedTickets: number;
      deletedTickets: number;
      totalTickets: number;
    };
  };
}