Player

Two endpoints: a public name lookup, and the license check used for member zones.

Look up a player name

Turns a Rankedin ID into the player's name — useful for showing readable names next to the IDs returned by the other endpoints.

curl -H "X-API-Key: your_api_key_here" \
  "https://rinpublicapistaging.azurewebsites.net/v1/player/R000006081"

{ "name": "Stefan Rankedin Support" }

This returns the player's public profile name, the same one shown on the Rankedin website, so it also works for players outside your organization. No other personal data is returned.

Errors

Check player license status

Checks whether players hold a valid license in your organization — for example when a player types their Rankedin ID into your federation's website to unlock a member zone or a sponsor discount.

You can check 1–20 players in a single request.

Request body

curl -X POST \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"rankedinIds": ["R000010970", "R000006081"]}' \
  "https://rinpublicapistaging.azurewebsites.net/v1/player/licenses/check"

{
  "results": [
    {
      "rankedinId":     "R000010970",
      "licenseStatus":  "active",
      "licenseType":    "Free yearly membership",
      "licenseExpires": "2026-09-11"
    }
  ],
  "notAvailable": [
    { "rankedinId": "R000006081", "reason": "not_in_organization" }
  ]
}

results[] — players in your organization

notAvailable[] — IDs that cannot be served

Good to know

• Match responses back to your input by rankedinId, not by position. Every ID you send comes back in exactly one of the two arrays, but the split means the order of results no longer matches the order of your request. Within each array the original relative order is kept, and duplicates are returned as many times as you sent them.
• The rankedinId is echoed back exactly as you typed it — send r000010970 in lower case and you get r000010970 back, even though the lookup itself ignores case.
• not_in_organization covers both "this player is not in your organization" and "this Rankedin ID does not exist" — the API does not tell the two apart.
• A player counts as belonging to your organization through a membership or a license record — so an expired license still appears in results, not in notAvailable.
• No personal data is returned: no name, e-mail, phone or home club. The endpoint only answers the license question.

Errors