Getting Started

Challonge API v2.1 is RESTful and follows the JSON:API specifications for request bodies and responses. All response codes, authentication, and verbs use standard HTTP.

Base URL

https://api.challonge.com/v2.1

Registration

To register your application and get keys, head to our Developer Portal at https://connect.challonge.com. You can then follow "Try it" buttons throughout the documentation to get responses to live API requests.

🔔 Please note that effective May 2026, our API requires a paid plan should you need more than 5,000* requests per month (* subject to change prior to official announcement). You can upgrade your app from the Developer Portal.

Common request headers

The following request headers should be present for all of your API requests:

Content-Type: application/vnd.api+json

Accept: application/json

And, if using OAuth:

Authorization-Type: v2

Authorization: Bearer the-long-oauth-token-goes-here

Or, if using an old API v1 key instead of OAuth:

Authorization-Type: v1

Authorization: api-v1-key-goes-here

Base URL#

Registration#

Common request headers#

Base URL

Registration

Common request headers