Get leaderboard by leaderboard ID submission by submission ID

GET /leaderboard/{leaderboard_id}/submission/{submission_id}

Path parameters

  • leaderboard_id string(uuid) Required

    Unique leaderboard ID used for querying.

  • submission_id string(uuid) Required

    Unique submission ID used for querying.

Responses

  • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • $schema string(uri)

      A URL to the JSON Schema for this object.

    • id string
    • last_submitted string(date-time) Required
    • leaderboard_id string Required

      9 character leaderboard ID used for querying.

    • leaderboard_title string Required

      Leaderboard title for associated submission.

    • score integer(int64) Required

      Current score of submission.

    • Additional properties are NOT allowed.

      Hide submitted_by attributes Show submitted_by attributes object
    • verified boolean Required

      Current verification status.

  • default application/problem+json

    Error

    Hide response attributes Show response attributes object
    • $schema string(uri)

      A URL to the JSON Schema for this object.

    • detail string

      A human-readable explanation specific to this occurrence of the problem.

    • errors array[object] | null

      Optional list of individual error details

      Hide errors attributes Show errors attributes object
      • location string

        Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

      • message string

        Error message text

      • The value at the given location

    • instance string(uri)

      A URI reference that identifies the specific occurrence of the problem.

    • status integer(int64)

      HTTP status code

    • title string

      A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

    • type string(uri)

      A URI reference to human-readable documentation for the error.

      Default value is about:blank.

GET /leaderboard/{leaderboard_id}/submission/{submission_id}
curl \
 --request GET https://api.topktoday.dev/leaderboard/146b2edf-2d6f-4775-9b86-5537a2649589/submission/146b2edf-2d6f-4775-9b86-5537a2649589
Response examples (200)
{
  "$schema": "https://api.topktoday.dev/schemas/DetailedSubmission.json",
  "id": "string",
  "last_submitted": "2025-05-04T09:42:00Z",
  "leaderboard_id": "EfhxLZ9ck",
  "leaderboard_title": "My First Leaderboard",
  "link": "https://www.youtube.com/watch?v=rdx0TPjX1qE",
  "score": 12,
  "submitted_by": {
    "added_at": "2025-05-04T09:42:00Z",
    "id": "string",
    "username": "greensuigi"
  },
  "verified": true
}
Response examples (default)
{
  "$schema": "https://api.topktoday.dev/schemas/ErrorModel.json",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "string",
      "message": "string"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}