Gallery Platform API
Reference

Start a plan checkout

Creates a hosted Stripe Checkout session that subscribes the organization to the requested paid plan, and returns its URL. Fails with a conflict while a live subscription exists — use the billing portal to switch plans.

POST
/org/billing/checkout

Creates a hosted Stripe Checkout session that subscribes the organization to the requested paid plan, and returns its URL. Fails with a conflict while a live subscription exists — use the billing portal to switch plans.

Authorization

bearerAuth billing:create
AuthorizationBearer <token>

A gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).

In: header

Scope: billing:create

Header Parameters

Idempotency-Key?string

Optional. Send a unique key per logical operation to make retries safe: a retry with the same key replays the stored success for 14 days instead of re-running the write. Reusing a key with a different body returns 400.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

The paid plan to start a subscription checkout for.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

{  "url": "string"}

List orders GET

Lists the gallery's event orders (purchases/RSVPs), most recent first, with cursor pagination. Filter by session or status.

Open the billing portal POST

Creates a hosted Stripe Billing Portal session for the organization's billing account and returns its URL. Fails with a conflict when the organization has never checked out.