Gem Version Documentation

A client wrapper for Relic APIs. Currently supports the Company of Heroes 3 leaderboard, stats, and recent matches API.


Add to Gemfile:

gem 'relic_link'

Then run bundle install.


Currently the only Relic API supported is the Company of Heroes 3 API (PRs are welcome for other games/APIs though, and others may be added based on resourcing and demand).

In order to make requests to the API, you need to initialize a client:

client =

Then you can make requests to any of the supported CoH3 API endpoints:

client.leaderboard(leaderboard_id: RelicLink::Coh3::Api::Endpoints::Leaderboards::Ids::AMERICAN_1V1)
client.recent_match_history(profile_ids: [8230])
client.personal_stats(profile_ids: [8230])

Consult the documentation for all endpoints that have been discovered and are currently queryable. Note that Relic does not publish official documentation for their endpoints, so the functionality here is based on best estimates and is subject to change without warning. Please open an issue if you are aware of endpoints that are not exposed in this library!


Bug reports and pull requests are welcome on GitHub at


The gem is available as open source under the terms of the MIT License.