NAV Navbar
Logo
shell

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.