Read a group-checkout share by capability token

GET

/g/{token}

const url = 'https://quikstik-core.fly.dev/g/example';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://quikstik-core.fly.dev/g/example

Reads the group-checkout context addressed by an opaque, unguessable capability token. This is not a session surface: there is no tenant header or bearer — the token in the path is the capability, scoped to a single payer’s share. Returns that payer’s split (group_index, server-priced amount_minor, currency), the optional payer identity, and the settlement status. An invalid or expired token is 404 (never disclosing whether a booking exists). Fail-closed: 503 when no backend is wired.

Parameters

Path Parameters

token

required

string

Opaque, unguessable group-checkout capability token.

Responses

200

Group-checkout share

application/json

A single payer’s share of a group checkout, scoped to one capability token — never the whole booking or other payers’ shares. Money-only: seats stay on the parent booking. The amount is server-priced; the payer never supplies it.

object

group_index

required

This payer’s index within the group.

integer format: int32

amount_minor

required

This share’s server-priced amount, in minor units (e.g. cents).

integer format: int64

currency

required

string

payer_name

string

nullable

payer_email

string

nullable

status

required

Whether this share has been settled.

string

Allowed values: pending paid

Example

{
  "currency": "USD",
  "status": "pending"
}

404

Invalid or expired token

application/json

object

reason

required

Stable, machine-readable reason code (e.g. “sold_out”, “processor_not_configured”, “rail_refused”).

string

Example

{
  "reason": "sold_out"
}

503

No durable backend is wired for this operation (fail-closed)

application/json

object

reason

required

Stable, machine-readable reason code (e.g. “sold_out”, “processor_not_configured”, “rail_refused”).

string

Example

{
  "reason": "sold_out"
}