API v1 was introduced many, many years ago. If you're just starting out, use v2.1 instead.Please note, this API version has no support for two-stage tournaments.Base URL#
Authentication#
All interactions with the API require a Challonge account with a verified email address and API key. You can generate one from your developer settings page. We support HTTP basic authentication. Username = your Challonge username, Password = your API key. Many clients format these requests as: https://username:api-key@api.challonge.com/v1/ Or, if you prefer, you can just pass your API key as parameter api_key to all method calls.API methods with GET request types are permitted for any tournament, whether belonging to you or not. All other API methods are scoped to tournaments that you either own or have admin access to.Response Codes#
The following HTTP response codes are issued by the API. All other codes are the result of a request not reaching the application.200 OK
401 Unauthorized (Invalid API key or insufficient permissions)
404 Object not found within your account scope
406 Requested format is not supported - request JSON or XML only
422 Validation error(s) for create or update method
500 Something went wrong on our end. If you continually receive this, please contact us.Validation Errors#
Requests that complete but have validation errors or other issues will return an array of error messages and status code 422. e.g.:{
"errors": [
"Name can't be blank",
"URL can't be blank"
]
}
Modified at 2025-11-05 16:02:33
