Pokemon Go API – Raid Bosses API

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

What is the Raid Bosses API

During the day Raid Boss eggs will hatch at gyms. These eggs will be ranked according to their tier, 1 to 5. The average strength of each tier is:

• Tier 1 – Easy Solo
• Tier 2 – Medium Solo
• Tier 3 – Hard Solo (may be impossible and need more)
• Tier 4 – Hard Duo (may be impossible and need more)
• Tier 5 – Hard Duo to Hard Quint (Tier 5 raid bosses strength vary wildly)

Some Tier 5 bosses are artificially made stronger and are given the stats of a “Tier 6”. These have typically been very weak Tier 5 bosses that needed to be made a bit stronger. These Tier 6 bosses will appear as a Tier 5 but will have the stats of a Tier 6. For simulation purposes it is important to know the distinction between a Tier 5 and 6 so the bosses rankings here are from Tier 1 to Tier 6 although in the wild you will only see Tier 1 to Tier 5.

Eggs will appear at gyms during the day and will be coloured according to its tier. Once the timer has expired the egg will “hatch” and display the boss that was inside the egg. This boss will then be able to be challenged during the entire time, until either you beat him or you run out of time. We know that bosses are chosen when the egg appears so when bosses change you will only see new bosses from eggs appearing after the changeover.

Once the boss has hatched and during the time a boss is occupying the gym you are not able to knock out Pokemon from the gym or add Pokemon to it if it is your teams gym.

Getting the Raid Bosses API Data

The API gives full details of past and current raid bosses.

GET /api/v1/raid_bosses.json

Returns a JSON dict with two keys, current and previous. Each of these hold dicts which have keys of 1 to 6 and the values are an array. Each array holds a dict with the following keys:

• boosted_weather – Array of weather types the boss will be boosted in. In these types it will be stronger to fight and be level 25 when caught.
• form – Form of the boss
• id – Pokemon ID of the boss
• max_boosted_cp – The combat power of a 15,15,15 100% IV boss caught when it is fought in boosted weather (level 25)
• max_unboosted_cp – The combat power of a 15,15,15 100% IV boss caught when it is fought in unboosted weather (level 20)
• min_boosted_cp – The combat power of a 10,10,10 66% IV boss caught when it is fought in boosted weather (level 25)
• min_unboosted_cp – The combat power of a 10,10,10 66% IV boss caught when it is fought in unboosted weather (level 20)
• name – name of the boss
• possible_shiny – true if the boss can be caught as a shiny
• type – Array of types the boss is

Example data

{
    "current": {
        "1": [
            {
                "boosted_weather": [
                    "Clear",
                    "Overcast"
                ],
                "form": "Normal",
                "id": 546,
                "max_boosted_cp": 500,
                "max_unboosted_cp": 400,
                "min_boosted_cp": 453,
                "min_unboosted_cp": 362,
                "name": "Cottonee",
                "possible_shiny": false,
                "tier": 1,
                "type": [
                    "Grass",
                    "Fairy"
                ]
            },
            {
                "boosted_weather": [
                    "Overcast"
                ],
                "form": "Normal",
                "id": 532,
                "max_boosted_cp": 939,
                "max_unboosted_cp": 751,
                "min_boosted_cp": 874,
                "min_unboosted_cp": 699,
                "name": "Timburr",
                "possible_shiny": true,
                "tier": 1,
                "type": [
                    "Fighting"
                ]
            }, ...
        ], ...
    },
    "previous": {
        "1": [
            {
                "boosted_weather": [
                    "Clear"
                ],
                "form": "Normal",
                "id": 252,
                "max_boosted_cp": 752,
                "max_unboosted_cp": 601,
                "min_boosted_cp": 695,
                "min_unboosted_cp": 556,
                "name": "Treecko",
                "possible_shiny": true,
                "tier": 1,
                "type": [
                    "Grass"
                ]
            }, ...
        ], ...
    }
}

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!