Getting Started
The Brawl Stars API provides near realtime access to game related data. In order to access the API, you need a developer account and a key for your application.
API Keys
Keys help in controlling access and traffic to the API. When creating a key you need to specify the IP addresses that are allowed to access the API endpoints. We recommend that you keep the keys private and create individual keys for each of your applications to avoid exceeding the rate limits unexpectedly.
Making Requests
To use the API, a JSON Web Token is required and it needs to be passed as part of every request. The token is bound to rate limitations and specified IP addresses, so you will need a web server to fetch data from the API and host your application. The API enforces these restrictions and exceeding the limitations will cause API calls to fail.
Visit the API Documentation page to explore and try out all the resources and operations supported by the API. Later on we will also provide code examples to get you started on developing applications.
Response Format and Status Codes
All API responses are JSON formatted documents with UTF8 encoded content. Standard HTTP status codes are used to indicate successful and error responses. In addition to standard error statuses, error responses are also JSON formatted and may contain additional information about the error.
API Terms and Conditions
See the Fan Content Policy page for detailed information.
Feedback and Questions
Your input is essential for us to make the API services better so please do discuss and give feedback using r/brawlstars on Reddit.
