Pokemon Go API – Go Battle Rankings Settings API

This post talks about the latest API I have added to PoGoAPI.net, the Mega Evolution Settings API.

What are the Go Battle Rankings Settings API

In Pokemon Go you are able to fight in the Battle League against other trainers. Here you battle in sets of five matches to receive rewards.

At the end of each set if you meet the requirements you will rank up to the next rank.

This holds the details of what you need to do to reach each rank, at which rank you can see your rating, and what you need to be eligible for rewards at the end of the season.

Getting the Go Battle Rankings Settings data

This API returns the game master settings for the Pokemon Go Battle league rankings.

GET /api/v1/gobattle_ranking_settings.json

Returns a JSON object with the following keys:

  • min_rank_to_display_rating – This is the minimum ranking you must be before your Go Battle league rating is displayed
  • rank_requirements – An array of objects with with at least the key rank telling you what you need to achieve to get to that rank level. Other keys include min_rating and additional_battles_required which define the rating you need to achieve to reach the rank and the number of battles you need to win in the previous rank to reach the next.
  • requirements_for_rewards – A dict with the keys min_total_battles and rank telling how many battles you have to fight and what rank you must be to be eligible for rewards at the end of the season.

Example data

    "min_rank_to_display_rating": 9,
    "rank_requirements": [
            "rank": 1
            "additional_battles_required": 5,
            "rank": 2
        }, ...
            "min_rating": 3000,
            "rank": 10
    "requirements_for_rewards": {
        "min_total_battles": 5,
        "rank": 1

The full documentation is available on the PoGoAPI.net documentation page.

If you have any questions about this API or suggestions for other API’s contact me here below or on Twitter!

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.