Competier
  1. ladder-entry
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-entry

Adds a self-managed entry to a ladder.

POST
/v1/ladder-entry
ladder-entry
Adds a self-managed entry to a ladder. Self-managed entries are not related to actual other Competier accounts - if you want your players to see and interact with your ladder in the Competier App, you need to send them an invite instead.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json
ladderId
integer 
required
id of the ladder that this ladder-entry belongs to.
Example:
0
name
string 
required
The display name for this ladder entry.
Example:
Jane Doe
rating
integer 
optional
Allows manually setting rating, for example when moving already existing ladders with ongoing ratings to Competier. Leave as default otherwise.
Example:
1500
reliabilityDeviation
integer 
optional
For Glicko algorithms: Allows manually setting relaibility deviation, for example when moving already existing ladders with ongoing ratings to Competier. Leave as default otherwise.
Example:
350
Example
{
  "ladderId": 0,
  "name": "Jane Doe",
  "rating": 1500,
  "reliabilityDeviation": 350
}

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 POST 'https://api.competier.net/v1/ladder-entry' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ladderId": 0,
    "name": "Jane Doe",
    "rating": 1500,
    "reliabilityDeviation": 350
}'

Responses

🟢200OK
application/json
Body
id
number 
read-onlyoptional
References a ladder-entry.
Example:
0
ladderId
integer 
required
id of the ladder that this ladder-entry belongs to.
Example:
0
name
string 
required
The display name for this ladder entry.
Example:
Jane Doe
rating
integer 
optional
Allows manually setting rating, for example when moving already existing ladders with ongoing ratings to Competier. Leave as default otherwise.
Example:
1500
reliabilityDeviation
integer 
optional
For Glicko algorithms: Allows manually setting relaibility deviation, for example when moving already existing ladders with ongoing ratings to Competier. Leave as default otherwise.
Example:
350
accountIds
array[integer]
read-onlyoptional
IDs of accounts represented by this entry. A ladder-entry representing real accounts will be generated in your ladder if those accounts accept invites to your ladder.
Example
{
  "id": 0,
  "ladderId": 0,
  "name": "Jane Doe",
  "rating": 1500,
  "reliabilityDeviation": 350,
  "accountIds": [
    0
  ]
}
🟠400Bad request
🟠401Unauthorized
🟠429Too Many Requests
Previous
Gets ladders of an account.
Next
Deletes a ladder-entry from a ladder, including all its ratings and results.
Built with