Introduction

Welcome to the OWAPI API. This API is based on Ovrstat by s32x

This API will be used in the Android Application OWidget 2. We recommend to use ow-api, but you can also use this API whenever you want.

I give no guarantee for the correctness of the sample data in this API, as this can always change.

This API documentation page was created with Slate.

Stats

Profile

curl https://owapi.eu/stats/pc/Domekologe-2110/profile

The above command returns JSON structured like this:

{
    "icon": "https://d15f34w2p8l1cc.cloudfront.net/overwatch/93516aaaa83146516809a259e4bbf3373726eda3b5adbfda0c02c777ab600df6.png",
    "name": "Domekologe",
    "endorsement": 3,
    "endorsementIcon": "https://static.playoverwatch.com/img/pages/career/icons/endorsement/3-8ccb5f0aef.svg#icon",
    "title": Fearsome Spirit",
    
    "ratings": [
        {
            "group": "Gold",
            "tier": 1,
            "role": "tank",
            "roleIcon": "https://static.playoverwatch.com/img/pages/career/icons/role/tank-f64702b684.svg#icon",
            "rankIcon": "https://static.playoverwatch.com/img/pages/career/icons/rank/GoldTier-1-44f03fb9ca.png",
        },
        {
            "group": "Gold",
            "tier": 2,
            "role": "offense",
            "roleIcon": https://static.playoverwatch.com/img/pages/career/icons/role/offense-ab1756f419.svg#icon",
            "rankIcon": https://static.playoverwatch.com/img/pages/career/icons/rank/GoldTier-2-c8e5a08e32.png",
        },
        {
            "group": "Gold",
            "tier": 5,
            "role": "support",
            "roleIcon": "https://static.playoverwatch.com/img/pages/career/icons/role/support-0258e13d85.svg#icon",
            "rankIcon": "https://static.playoverwatch.com/img/pages/career/icons/rank/GoldTier-5-4f4894b821.png",
        }
    ]
    "private": false
}

This endpoint retrieves stats commonly used by bots and other services.

HTTP Request

GET https://owapi.eu/stats/:platform/:battletag/profile

URL Parameters

Parameter	Description
platform	The game platform (pc, console)
battletag	Your battlenet tag (e.g. Domekologe-2110)

Complete stats

curl https://owapi.eu/stats/pc/Domekologe-2110/complete

The above command returns JSON structured like this:

{
    "icon": "https://d15f34w2p8l1cc.cloudfront.net/overwatch/93516aaaa83146516809a259e4bbf3373726eda3b5adbfda0c02c777ab600df6.png",
    "name": "Domekologe",
    "endorsement": 3,
    "endorsementIcon": "https://static.playoverwatch.com/img/pages/career/icons/endorsement/3-8ccb5f0aef.svg#icon",
    "title": Fearsome Spirit",
    "ratings": [
        {
            "group": "Gold",
            "tier": 1,
            "role": "tank",
            "roleIcon": "https://static.playoverwatch.com/img/pages/career/icons/role/tank-f64702b684.svg#icon",
            "rankIcon": "https://static.playoverwatch.com/img/pages/career/icons/rank/GoldTier-1-44f03fb9ca.png",
        },
        {
            "group": "Gold",
            "tier": 2,
            "role": "offense",
            "roleIcon": https://static.playoverwatch.com/img/pages/career/icons/role/offense-ab1756f419.svg#icon",
            "rankIcon": https://static.playoverwatch.com/img/pages/career/icons/rank/GoldTier-2-c8e5a08e32.png",
        },
        {
            "group": "Gold",
            "tier": 5,
            "role": "support",
            "roleIcon": "https://static.playoverwatch.com/img/pages/career/icons/role/support-0258e13d85.svg#icon",
            "rankIcon": "https://static.playoverwatch.com/img/pages/career/icons/rank/GoldTier-5-4f4894b821.png",
        }
    ],
    "gamesPlayed": "5493",
    "gamesWon": 2651,
    "gamesLost": 2841,
    "quickPlayStats": {
        "eliminationsAvg": 11.77,
        "damageDoneAvg": 5358,
        "deathsAvg": 5.88,
        "finalBlowsAvg": 5.6,
        "healingDoneAvg": 1100,
        "objectiveKillsAvg": 4.29,
        "objectiveTimeAvg": "00:32",
        "soloKillsAvg": 1.67,
        "games": {
            "played": 0,
            "won": 716
        },
        "topHeroes": { ... },
        "careerStats": { ... }
    },
    "competitiveStats": {
        "eliminationsAvg": 22.25,
        "damageDoneAvg": 12056,
        "deathsAvg": 9.76,
        "finalBlowsAvg": 11.76,
        "healingDoneAvg": 2392,
        "objectiveKillsAvg": 9.82,
        "objectiveTimeAvg": "01:10",
        "soloKillsAvg": 2.53,
        "games": {
            "played": 39,
            "won": 18
        },
        "topHeroes": { ... },
        "careerStats": { ... }
    },
    "private": false
}

This endpoint retrieves all profile data, including top heroes and career stats. It is a VERY heavy endpoint, and should only be used when you need all stats. Data returned is most of the time around 100KB.

HTTP Request

GET https://owapi.eu/stats/:platform/:battletag/complete

URL Parameters

Parameter	Description
platform	The game platform (pc, console)
battletag	Your battlenet tag (e.g. Domekologe-2110)

OWAPI uses the following error codes:

Error Code	Meaning
400	Bad Request – Your request sucks
404	Not Found – The specified profile could not be found
406	Not Acceptable – You requested a format that isn’t json
500	Internal Server Error – We had a problem with our server. Try again later.
503	Service Unavailable – We’re temporarily offline for maintenance. Please try again later.