Skip to main content

Distribution API

The Distribution API is not an open API. It is only for distributors Gomry has approved and signed terms with. There is no self-serve sign-up: Gomry reviews each distributor, agrees its terms and credit limit, and issues every key itself. If Gomry has not approved you, these pages do not give you access. To apply, contact support@gomry.com.
A distributor buys Gomry tickets at wholesale and resells them on outside marketplaces (StubHub, Vivid Seats, SeatGeek and the like), and seats on Gomry experiences (tours, classes, workshops) on tours-and-activities marketplaces. Both are products, sold the same way. Gomry is the seller. Organizers opt in on their side; you never deal with them, and their names are not passed to you.
You are the client for every endpoint here. Gomry never calls your systems. You poll for changes: products, and orders Gomry cancelled.

How a sale flows

1

List

Read products (events and experiences, one shape) every few minutes, or a product’s sessions live. List exactly what it returns, at the quantities it returns, and take down anything it no longer returns.
2

Sell

When a buyer buys on a marketplace, place an order with your own order reference. Gomry issues the tickets at once.
3

Deliver

Deliver each ticket’s code to the buyer, with its Gomry link. Gomry scans the code at the door.
4

Pay

Pay Gomry what the statement says you owe. Gomry records the payment against those orders.

Base URL

Authentication

Send your key on every request:
Gomry shows a key once, when it issues it, and keeps only a fingerprint. Store it as a secret on your server. If it leaks, ask Gomry for a new one: the old key stops working the moment the new one is issued.

Money

Refunds and customer service for your buyers are yours. Gomry never refunds a buyer you sold to.

Limits

20 requests per second per distributor. Past that, Gomry answers 429 with Retry-After: 1.

Errors

Every error has the same shape. Branch on code, never on message.