API v1

GolTrivia REST API

Build clients, dashboards and integrations on top of GolTrivia. All endpoints are JSON, authenticated with bearer tokens.

base: https://api.goltrivia.app

Bearer auth

v1.4.0

Auth

POST/v1/auth/signup

Live

Create account. Returns access + refresh tokens.

POST/v1/auth/login

Live

Email + password sign-in.

POST/v1/auth/refresh

Live

Exchange refresh token for new access token.

POST/v1/auth/logout

Live

Invalidate refresh token.

Request

curl -X POST https://api.goltrivia.app/v1/matches/m_8x2/answer \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "card_id": "c_0042",
    "answer": "CR7",
    "elapsed_ms": 4820
  }'

200 OK

{
  "ok": true,
  "card": { "id": "c_0042", "answer": "Cristiano Ronaldo" },
  "match_turn": {
    "match_id": "m_8x2",
    "player": "u_diego",
    "points": 4,
    "correct": true,
    "elapsed_ms": 4820
  },
  "next_turn": "u_sofia"
}