Skip to main content

​
Overview

The Wordgrid leaderboard API is a simple HTTP JSON API for retrieving and submitting daily game scores. It exposes two endpoints and requires no authentication. Base URL: https://wordgrid-api.proplayer919.dev:7000
No authentication is required to use any leaderboard endpoint.

​
GET /leaderboard/{date}

Retrieve all leaderboard entries for a given date. Method: GET
Path: /leaderboard/{date}

​
Path parameters

​
date
string
required
The date to retrieve scores for, in YYYY-MM-DD format (e.g. 2025-01-15). Maximum 10 characters.

​
Response

Returns a JSON array of leaderboard entry objects. Entries are sorted ascending by score at the server level. Status: 200 OK
​
name
string
The player’s name.
​
score
integer
The player’s numeric score.
​
date
string
The date the score was submitted, in YYYY-MM-DD format.

​
Example request

curl https://wordgrid-api.proplayer919.dev:7000/leaderboard/2025-01-15

​
Example response

[
  { "name": "alice", "score": 42, "date": "2025-01-15" },
  { "name": "bob", "score": 87, "date": "2025-01-15" },
  { "name": "carol", "score": 134, "date": "2025-01-15" }
]

​
POST /leaderboard

Submit a new score to the leaderboard. Method: POST
Path: /leaderboard
Content-Type: application/json
There is no deduplication. Multiple entries with the same name and date are allowed.

​
Request body

​
name
string
required
The player’s name. Cannot be empty. Maximum 50 characters.
​
score
integer
required
The player’s numeric score.
​
date
string
required
The date for the score, in YYYY-MM-DD format. Cannot be empty. Maximum 10 characters.

​
Responses

201 Created — Score submitted successfully. 
{ "message": "Score added successfully!" }
400 Bad Request — Submission failed. Possible error responses:
Error messageCause
"Invalid data!"One or more required fields (name, score, date) are missing.
"Invalid data types!"A field has the wrong type (name or date is not a string, or score is not an integer).
"Name and date cannot be empty!"name or date is an empty string.
"Name is too long!"name exceeds 50 characters.
"Date is too long!"date exceeds 10 characters.

​
Example request

curl -X POST https://wordgrid-api.proplayer919.dev:7000/leaderboard \
  -H "Content-Type: application/json" \
  -d '{"name": "alice", "score": 42, "date": "2025-01-15"}'

​
Example response

{ "message": "Score added successfully!" }

Build docs developers (and LLMs) love

Get started for freeTalk to us