Tournament API

The Tournament API is a public API that enables Tournament Organizations (TO) to more effectively use rewind.lol.

Signup and Verification

1. You must be (or represent) a current tournament organization for League of Legends. Individuals not representing a TO as a staff member will be denied access to the API. Using a tournament organization’s API key for personal purposes may result in access termination.
2. You will be asked to provide evidence of:
   • previous tournament history
   • upcoming events
   • active participation by members
   • rules of participation and/or terms of service
3. Once approved, you may be required to join the Patreon “Tournament API Access” tier to satisfy the setup fee.
   • Please see the “Setup Fee” section below for more information.
4. A key will be manually issued within 1 business day. A tentative quota will be set based on the frequency and size of tournaments.
5. A representative from your tournament organization must remain in the rewind.lol discord server.

Setup Fee

The setup fee is a payment made to rewind.lol after registration approval. The fee covers the cost of labor for conducting a tournament history audit, issuing a new key, assigning permissions, and onboarding instructions. Ongoing Patreon membership is not required after the setup fee is paid.

1. Receive approval in step 3 from “Signup and Verification” above. This setup fee is not a registration fee. Do not send payment before receiving approval.
2. Payment may be accomplished through PayPal donation or Patreon subscription worth 5 USD.
   • PayPal: please go to the rewind.lol donation page. It is not linked in email or direct message communications for security reasons. Enter the (gross) donation amount as 5 USD.
   • Patreon: please go to the rewind.lol patreon page (iaace LLC). Join the “Tournament API Access” tier for at least one month.
3. Please notify iaace of the method of payment to continue the onboarding process.

Although a Patreon membership is not required to use the Tournament API service, having one does give the ability for the tournament Patreon account to generate custom profiles for any user which automatically have the history page enabled with an unrestricted history length. This feature is not enabled automatically so please contact iaace if you need this feature.

API Service

1. Usage of the tournament API should be restricted to TO staff only.
2. There is no SLA. Check the discord announcements channel, https://status.rewind.lol, or the rewind.lol home page for downtime and maintenance notifications.

API Authentication

1. All API requests are served via HTTPS.
2. All API responses are in JSON format.
3. All API requests require a ?api_key= query parameter.
   • The reference pages/API forms also require a ?api_key= query parameter.
4. Some API requests incur a quota cost. If there is not enough quota remaining to complete a request, there will be a 400 status response.
5. Issued API keys are permanent and belong solely to the tournament organization they were issued to.
6. If reasonable care is not taken to secure issued API keys, access may be suspended.
7. If the assigned API key becomes compromised, please notify iaace immediately for issuance of a new key.

API Quota

1. If the quota approaches 0, please reach out to iaace for an increase/reset. There is no fee associated with quota increases.
2. Quotas do not reset at regular intervals automatically. This is for manual auditing purposes.
3. There is no rate limit enforced for legitimate requests. However, if your application averages more than 1 request per hour, please notify iaace.

API Forms

1. You’re welcome to implement the rewind.lol API in your own applications provided you continue to satisfy the requirements necessary to use the API.
2. Otherwise, no coding is necessary and you may use the reference implementation pages.
3. Attribution is not required- You are not required to publicly disclose that the source of data comes from rewind.lol. However, you cannot intentionally misrepresent the source of data.

Available Endpoints

GET https://rewind.lol/api/quota

Check the amount of remaining calls your API key has.

• Quota cost: 0

GET https://rewind.lol/api/update

Add a profile to the queue. These update requests are deprioritized over captcha-verified human requests.

• Quota cost: 1
• Reference Implementation: https://rewind.lol/api/update_form.html

GET https://rewind.lol/api/ignlookup/:region/:ign

Begin a username history search.

• Quota cost: 3
• Reference Implementation: https://rewind.lol/api/username_form.html
• ign: not case sensitive, not white-space sensitive
• Additional terms and conditions apply, see the Username Search Addendum below.

GET https://rewind.lol/api/results/:request_id

Retrieve a previous result for username history.

• Quota cost: 0
• Reference Implementation: https://rewind.lol/api/username_form.html
• Additional terms and conditions apply, see the Username Search Addendum below.

Username Search Addendum

Warning

Access to these tools is restricted:

• You must be a representative of a Tournament Organization registered with rewind.lol.
• The results of automated (non-manual) searches should not be returned to any end-users (non-staff, usually prospective tournament participants). End-users should not be allowed to execute arbitrary searches.
  • Example: A username search can be automatically triggered when a user signs up. However, the user should not be shown the results of this search.
  • Screenshot results of any automated or manual search can be published as evidence for the public to view.
• The purpose of executing any username searches is solely limited to one of either:
  • competitive integrity reasons: investigation of tournament participants for potential
    • account sharing
    • smurfing
    • or ban evasion
  • indiscriminate testing purposes: exploring/verifying the features of this tool on random users or consenting users without performing any investigation on any accounts

The following is a non-exhaustive list of reasons that are unsanctioned and will result in access termination:

• Stalking
• Harassment
• Doxxing
• Information Harvesting
• Attempting to locate lost friends
• Any other purpose not directly related to Tournament Operations

All queries AND query attempts performed are logged and will include the following information:

• IP addresses
• Approximate location
• Date
• Time
• Query keywords
• Query results
• Tournament Organization name

By performing any search, you are consenting to the collection and storage of this information in perpetuity. You cannot revoke this consent after performing a search. We will also reserve the right for public users to be able to see if their account was ever a result in any search. We will use the logged information listed above to provide the user with the Date, Time, and Tournament Organization name that queried their information.