Skip to content

Esports Hub API

Last updated 12 November 2026

A small, read-only API for organisers who want their event numbers in their own sheet or tool. It returns event details and counts. It never returns people.

Before you start

You need a free Esports Hub account. Open Account in the app and make a key. The key is shown once, so copy it then. You can have up to 5 keys and revoke any of them at any time. A key only reads. It cannot change anything.

This is a small free service run by one person. There is no uptime promise and no support promise. The API may change, and if it does this page will say so.

Base URL and sign-in

Send every request to the Esports Hub server with your key in the Authorization header. The API is for servers and scripts: it does not allow calls from other websites, so do not put your key in a web page.

Authorization: Bearer ehk_your_key_here

The base URL is the address of the Esports Hub server, followed by /api/v1. Only GET requests work. Your key works on this API and nowhere else, and your normal sign-in does not work here.

The two endpoints

  • GET /api/v1/events returns up to 50 of your events, each with its counts.
  • GET /api/v1/events/:id/summary returns one event. You get a 404 if the key owner cannot see that event.

What comes back

An event has an id, key, name, game, date, startsOn and createdAt. The counts are:

  • registrations: total, pending, approved and byStatus.
  • checkIns: a number.
  • liveViews: total and bySource, such as the live page and embeds.

The list endpoint answers { "events": [ ... ] }. The summary endpoint answers { "event": { ... }, "counts": { ... } }. Names, emails, photos, rosters and contact details are never part of any answer.

Limits

Each key may make 60 requests a minute, and each address 120 a minute. Past that you get a 429 answer: wait and try again. Keep your requests few. The numbers do not change second by second.

If a key leaks, revoke it in Account. It stops working straight away.

Questions

Found a problem or need another field? Tell us. See the privacy policy for what is stored.