Getting Started

Challonge API v2.1 is RESTful and follows 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 our API now requires a paid plan for more than 500 requests per month. Our grace period will end July 1, 2026, at which point free apps over the limit will receive a 429 response code (Too Many Requests). You can view your usage and upgrade 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