Competier
  1. ladder
Competier
  • api-key
    • Creates and returns a new api key, invalidating the previous one.
      POST
  • ladder
    • Adds a ladder to an account.
      POST
    • Deletes a ladder from an account, including all its entries, ratings and results.
      DELETE
    • Gets ladders of an account.
      GET
  • ladder-entry
    • Adds a self-managed entry to a ladder.
      POST
    • Deletes a ladder-entry from a ladder, including all its ratings and results.
      DELETE
    • Gets ladder entries.
      GET
  • result
    • Adds a game result for a played game.
      POST
    • Deletes a game result by rolling it back, reverting rating changes.
      DELETE
    • Gets game results.
      GET
  • invite
    • Adds an invite.
      POST
    • Accepts an invite.
      PUT
    • Deletes an invite.
      DELETE
    • Gets invites.
      GET
  • account
    • Updates account data.
      PATCH
  • credit
    • Fetches credit info.
      GET
  • matchmaking
  • bulk
  1. ladder

Gets ladders of an account.

GET
/v1/ladders
ladder
Gets ladders of an account. Includes ladders which this account is the admin of, as well as ladders in which this account is participating in as a ladder-entry.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params
adminOnly
array[boolean]
optional
Whether to only return ladders which this account is the admin of.

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.competier.net/v1/ladders'

Responses

🟢200OK
application/json
Body
array of:
id
number 
read-onlyoptional
References a ladder.
Example:
0
name
string 
required
The display name for this ladder.
Example:
My Ladder
ratingAlgorithm
string 
optional
Rating algorithm to use. We support Elo, Glicko-1 and Glicko-2. If you don't have any particular requirements and/or don't know about the details of each algorithm, then we usually recommend Glicko-1.
Example:
Glicko-1
glickoCValue
number 
optional
Default:
18.13
glicko2RValue
number 
optional
Default:
0.5
playersCanEnterResults
boolean 
optional
Allows players to add and remove results. If allowFullResultHistory is set, players can also add and remove results they haven't themselves participated in.
Example:
false
allowFullResultHistory
boolean 
optional
Allows players to see the result history of all other players of this competition, not just their own.
Example:
true
Example
[
  {
    "id": 0,
    "name": "My Ladder",
    "ratingAlgorithm": "Glicko-1",
    "glickoCValue": 18.13,
    "glicko2RValue": 0.5,
    "playersCanEnterResults": false,
    "allowFullResultHistory": true
  }
]
🟠400Bad request
🟠401Unauthorized
🟠429Too Many Requests
Previous
Deletes a ladder from an account, including all its entries, ratings and results.
Next
Adds a self-managed entry to a ladder.
Built with