Browse API docs

Sales points

A sales point is a business that sells your tickets at its own counter: a ticket shop, a tourist office, a box office in town. Its people sign in to the Usetix box office app, sell your events there and take the money in their own till. Every sale is an order with origin box_office, outside_payment.method sales_point and the sales_point that sold it. Its Usetix fee comes from your Usetix Credit.

A sales point sells every event or the ones you choose, the places held for it as an allotment and, unless you switch it off, every free place.

These endpoints need a venue token (owner or manager). Co-organizer tokens and Usetix support can’t use them.

GET /admin/sales_points

Lists the sales points that aren’t archived, each with what it sold since its last settlement.

curl -H "Authorization: Bearer your-token-here" \
  -H "Accept: application/json" \
  https://app.usetix.io/admin/sales_points

Response:

{
  "sales_points": [
    {
      "id": "u4Nq8sKdW2xZ7bLm3pRt9vYc",
      "name": "City Box Office",
      "contact_name": "Anna Weber",
      "email": "info@cityboxoffice.example",
      "phone": "+49 6441 000000",
      "all_events": false,
      "event_ids": [42, 57],
      "sells_open_inventory": true,
      "archived_at": null,
      "open_since": "2026-11-01T08:00:00Z",
      "open_sales": {
        "order_count": 18,
        "ticket_count": 41,
        "sales": { "amount": "1722.00", "currency": "EUR" },
        "refunded": { "amount": "42.00", "currency": "EUR" },
        "owed": { "amount": "1680.00", "currency": "EUR" },
        "usetix_fees": { "amount": "41.00", "currency": "EUR" }
      }
    }
  ]
}

GET /admin/sales_points/:id

Returns one sales point, archived ones included, with its latest 24 settlements (settlement fields). id is the sales point’s id above. Its sales are in the orders with its sales_point.

GET /admin/sales_points/:id.csv exports its sales as CSV, with the same Bearer token: a GET of a CSV, Excel or PDF export authenticates like a JSON request.

POST /admin/sales_points

curl -X POST \
  -H "Authorization: Bearer your-token-here" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"sales_point": {"name": "City Box Office", "email": "info@cityboxoffice.example", "all_events": false, "event_ids": [42, 57]}}' \
  https://app.usetix.io/admin/sales_points

Parameters (under sales_point):

Parameter Description
name Required. Shown on the seat map and in the box office app.
contact_name, email, phone Who you deal with there.
note A note for your team.
all_events true (default) sells every event; false only event_ids.
event_ids The numeric ids of the events it sells when all_events is false.
sells_open_inventory true (default) sells every free place; false only its allotments.

Response: 201 Created with the sales point and a Location header. Validation errors return 422.

PATCH /admin/sales_points/:id

Changes the same fields. Returns 200 with the sales point.

POST /admin/sales_points/:id/archival

Archives a sales point that no longer sells: its people can no longer sign in to the box office app. Its sales and settlements stay. Archiving it again changes nothing. Returns 200 with the sales point.

POST /admin/sales_points/:id/invitations

Invites someone to sell at the sales point. A shared address such as the counter’s works.

curl -X POST \
  -H "Authorization: Bearer your-token-here" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"email": "counter@cityboxoffice.example"}' \
  https://app.usetix.io/admin/sales_points/u4Nq8sKdW2xZ7bLm3pRt9vYc/invitations

Returns 201 with the invitation, role sales_point and its sales_point. Once accepted, the person is a team member with that role. They see only the box office app: no admin, scanner, API tokens or MCP.

POST /admin/sales_points/:id/settlements

Settles what the sales point sold up to now. The settlement keeps the figures as they are; the next period starts where it ends. A refund after a settlement counts in the next one.

curl -X POST \
  -H "Authorization: Bearer your-token-here" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"note": "Transfer of 12 Nov"}' \
  https://app.usetix.io/admin/sales_points/u4Nq8sKdW2xZ7bLm3pRt9vYc/settlements

Response: 201 Created:

{
  "id": 7,
  "period_start": "2026-11-01T08:00:00Z",
  "period_end": "2026-11-12T09:30:00Z",
  "order_count": 18,
  "ticket_count": 41,
  "sales": { "amount": "1722.00", "currency": "EUR" },
  "refunded": { "amount": "42.00", "currency": "EUR" },
  "net": { "amount": "1680.00", "currency": "EUR" },
  "note": "Transfer of 12 Nov",
  "created_at": "2026-11-12T09:30:00Z"
}

DELETE /admin/sales_points/:id/settlements/:settlement_id

Takes the latest settlement back, for example after settling by mistake. Returns 204 No Content; an earlier settlement returns 422.

Sales point fields

Field Type Notes
id string Public ID, used in the URLs above and in orders’ sales_point.id.
all_events, event_ids boolean, integer[] Which events it sells. event_ids is empty while all_events is true.
sells_open_inventory boolean Whether it sells free places or only its allotments.
note string | null Your team’s note.
archived_at string | null ISO 8601 UTC.
open_since string Where the open period starts: the end of the last settlement, or when the sales point was added.
open_sales.sales money What it sold in the open period, by payment time.
open_sales.refunded money What it paid back in the open period.
open_sales.owed money sales less refunded: what it owes you.
open_sales.usetix_fees money For information: the Usetix fees these sales took from your Usetix Credit.

Commission for the sales point is between you and it and not part of Usetix.