Pokemon Go API – Badges API

This post talks about the latest API I have added to PoGoAPI.net, the Badges API.

What is the Badges API

While playing Pokemon Go, certain actions are tracked and your progress is logged in the form of badges. When you reach certain milestones you are given a badge to mark your achievement.

Standard badges typically have three levels, bronze, silver, and gold. These badges are displayed in your player profile and can be used to judge your progress.

In addition to tracking progress in various statistics, badges are also used to track participation at certain Pokemon Go Special Weekends and events.

These badges are called “event badges” and given for participation in the event. This typically requires purchasing a ticket and physically going to the event location.

Getting the Badge data

This API returns the currently available badges in the game and details what is needed to achieve them for non-event badges.

GET /api/v1/badges.json

Returns a JSON array of objects. Each object will have the the following keys:

• name – Name of the Badge
• description – Description of the badge
• event_badge – True if the badge is an event badge, false if it is a badge that can be unlocked via normal play
• rank – An integer representing how important the badge is. The lower the number the higher the badge will be displayed in Pokemon Go
• targets (optional) – A list of integers representing the value that you must reach in the badges statistic to gain each level

Example data

[
 {
        "description": "South Korea, July 29, 2018",
        "event_badge": true,
        "name": "Pokemon GO Special Weekend, July 29, 2018",
        "rank": 2
    },
    {
        "description": "Win {0} Gym battles.",
        "event_badge": false,
        "name": "Battle Girl",
        "rank": 4,
        "targets": [
            10,
            100,
            1000
        ]
    }, ...
]

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!