Team-Up Elo Rating API
API for managing Elo ratings across various game formats and team sizes
Version: 1.0.0
API Endpoint
https://kh3pbctcnk.execute-api.us-east-2.amazonaws.com/team-up-api /clear_all_client_data Delete all data associated with a client
Permanently removes all leaderboards, matches, ratings, and metadata associated with a client
/delete_leaderboard Delete a leaderboard and all associated data
Permanently removes a leaderboard and all its associated matches, ratings, metadata, and history
/export_leaderboard Export a leaderboard's data
Export ratings, profiles, and limited match history for a leaderboard
/get_api_docs Get API documentation
Retrieve the complete OpenAPI specification for the Team Up API
/get_client_leaderboards Get a list of all leaderboards for a client
Retrieves all leaderboards and their metadata for a given client ID
/get_client_profile Get a client's profile information
Retrieve display settings, metadata, and configuration for a specific client
/get_default_leaderboard Get a client's default leaderboard
Retrieve the configured default leaderboard for a specific client
/get_default_rating_type Get a client's default rating type
Retrieve the configured default rating type and associated parameters for a specific client
/get_entity_head_to_head Get head-to-head statistics between two entities
Retrieve detailed head-to-head match statistics between two players or teams
/get_leaderboard Get ratings for a specific leaderboard
Retrieve ratings for a specific leaderboard and rating type, sorted by rating in descending order.
Supports pagination and filtering by rating type, with optional parameters for specific formats.
/get_leaderboard_profile Get a leaderboard's profile information
Retrieve profile data for a specific leaderboard including display settings and tiers
/get_leaderboard_history Get match history for a leaderboard
Retrieve paginated match history for a specific leaderboard, sorted by timestamp in descending order
/get_leaderboard_rating_types List available rating types for a leaderboard
Retrieve all rating types that have data for the specified leaderboard
/get_player_history Get match history for a specific player
Retrieve paginated match history for a specific player across all leaderboards
/get_player_profile Get a player's profile information
Retrieve display settings and metadata for a specific player
/get_player_rating Get a player's rating for a specific leaderboard
Retrieve a player's Elo rating, match count, and associated metadata for a specific leaderboard and rating type
/get_player_rating_history Get a player's rating history over time
Retrieve a player's Elo rating changes over time for a specific leaderboard and rating type
/get_player_stats Get comprehensive player statistics
Retrieve a player's comprehensive statistics including current rating, match history, placement counts, and more
/get_random_active_clients Get a random selection of active clients
Retrieves a random sample of active client IDs (with current subscriptions) for discovery purposes
/get_random_clients Get a random selection of clients
Retrieves a random sample of client IDs for discovery and testing purposes using a random seed index
/get_rating_history Get rating history for a specific rating type
Retrieve paginated match history with rating changes for a specific leaderboard and rating type
/get_subscription_tier Get a client's subscription tier
Retrieve the current subscription tier and limits for a client
/get_team_history Get match history for a specific team
Retrieve paginated match history for a specific team combination
/get_team_profile Get a team's profile information
Retrieve display settings and metadata for a specific team combination
/get_team_rating Get a team's rating for a specific leaderboard
Retrieve a team's Elo rating, match count, and associated metadata for a specific leaderboard and rating type
/import_leaderboard Import a new leaderboard
Create a new leaderboard from exported data. Will fail if the leaderboard already exists.
/record_match Record a new match
Record match results and update ratings for all applicable rating types.
Supports multiple team sizes and formats including 1v1, 2v2, 2v6, 1v1v1, 2v2v2 and more.
/record_match_with_deltas Record a match with pre-calculated rating deltas
Record match results using provided rating changes rather than calculating them internally
/set_client_profile Set or update a client's profile information
Configure display settings and metadata for a client.
Sending an empty object will delete the profile.
Invalid keys will be ignored and reported in the response.
/set_leaderboard_profile Set or update a leaderboard's display information
Configure display settings and metadata for a leaderboard
/set_player_connection Set or remove a gaming platform connection for a player
Update or remove a gaming platform connection for a player.
Providing neither id nor name will remove the connection.
/set_player_profile Set or update a player's profile information
Update display information and connection details for a player ID
/set_player_rating Set a player's rating manually
Manually set a player's Elo rating for a specific leaderboard and rating type.
This operation requires authentication and administrative privileges.
/set_rating_visibility Set visibility of ratings for a player or team
Configure whether a player's or team's ratings are hidden from leaderboards
/set_team_profile Set or update a team's profile information
Associate display information for a specific team combination of players
/sync_leaderboard_messages Synchronize leaderboard messages in Discord
Updates Discord messages that display leaderboards or match history with the latest data.
Queries tracked messages from the database and updates them with current rankings and stats.
Automatically handles message deletion if messages no longer exist in Discord.
Includes rate limiting to prevent Discord API abuse.
/sync_player_tier_roles Synchronize Discord tier roles for players
Checks which tier roles players should have based on their current ratings and optionally updates their Discord roles.
Compares player ratings against leaderboard tier requirements and identifies missing or incorrect roles.
For Discord integration only - requires a DISCORD| prefixed client_id.
Includes rate limiting to prevent Discord API abuse.
/undo_last_match Undo the most recently recorded match
Remove the last recorded match and revert its Elo rating changes. This will update the match history, rating records, and metadata counters accordingly.