Activision Blizzard Covenant API
The Covenant API API from Activision Blizzard — 7 operation(s) for covenant api.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/activision-blizzard:activision-blizzard-covenant-api-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Battle.net World of Warcraft Covenant API
version: 1.0.0
description: World of Warcraft API from Blizzard Entertainment (Activision Blizzard, part of Microsoft Gaming), converted field-for-field from the machine-readable API reference the Battle.net Community Developer Portal serves at community.developer.battle.net/api/pages/content/documentation/*.json (saved verbatim in openapi/_original/battle-net-reference/). Response schemas are not published in that reference.
contact:
name: Battle.net Community Developer Portal
url: https://community.developer.battle.net/
termsOfService: https://www.blizzard.com/en-us/legal/a2aefd3f-87e1-4a35-a38d-e0f7a8f42a00/blizzard-developer-api-terms-of-use
x-generated-from: provider-reference-json
x-derived-from:
- openapi/_original/battle-net-reference/world-of-warcraft-game-data-apis.json
- openapi/_original/battle-net-reference/world-of-warcraft-profile-apis.json
x-derived: '2026-11-04'
servers:
- url: https://{region}.api.blizzard.com
description: Global regions (documented host format {region}.api.blizzard.com)
variables:
region:
enum:
- us
- eu
- kr
- tw
default: us
- url: https://gateway.battlenet.com.cn
description: China region host (documented in Regionality and APIs / game data host names)
security:
- oauth2: []
tags:
- name: Covenant API
paths:
/data/wow/covenant/index:
get:
operationId: covenantIndex
summary: Covenant Index
description: Returns an index of covenants.
tags:
- Covenant API
x-source: https://community.developer.battle.net/documentation/world-of-warcraft/game-data-apis
parameters:
- name: namespace
in: query
required: true
description: The namespace to use to locate this document.
schema:
type: string
default: static-us
- name: locale
in: query
required: false
description: The locale to reflect in localized data.
schema:
type: string
default: en_US
responses:
'200':
description: Successful response (response schema not published in the reference).
/data/wow/covenant/{covenantId}:
get:
operationId: covenant
summary: Covenant
description: Returns a covenant by ID.
tags:
- Covenant API
x-source: https://community.developer.battle.net/documentation/world-of-warcraft/game-data-apis
parameters:
- name: covenantId
in: path
required: true
description: The ID of the covenant.
schema:
type: integer
default: 1
- name: namespace
in: query
required: true
description: The namespace to use to locate this document.
schema:
type: string
default: static-us
- name: locale
in: query
required: false
description: The locale to reflect in localized data.
schema:
type: string
default: en_US
responses:
'200':
description: Successful response (response schema not published in the reference).
/data/wow/media/covenant/{covenantId}:
get:
operationId: covenantMedia
summary: Covenant Media
description: Returns media for a covenant by ID.
tags:
- Covenant API
x-source: https://community.developer.battle.net/documentation/world-of-warcraft/game-data-apis
parameters:
- name: covenantId
in: path
required: true
description: The ID of the covenant.
schema:
type: integer
default: 1
- name: namespace
in: query
required: true
description: The namespace to use to locate this document.
schema:
type: string
default: static-us
- name: locale
in: query
required: false
description: The locale to reflect in localized data.
schema:
type: string
default: en_US
responses:
'200':
description: Successful response (response schema not published in the reference).
/data/wow/covenant/soulbind/index:
get:
operationId: soulbindIndex
summary: Soulbind Index
description: Returns an index of soulbinds.
tags:
- Covenant API
x-source: https://community.developer.battle.net/documentation/world-of-warcraft/game-data-apis
parameters:
- name: namespace
in: query
required: true
description: The namespace to use to locate this document.
schema:
type: string
default: static-us
- name: locale
in: query
required: false
description: The locale to reflect in localized data.
schema:
type: string
default: en_US
responses:
'200':
description: Successful response (response schema not published in the reference).
/data/wow/covenant/soulbind/{soulbindId}:
get:
operationId: soulbind
summary: Soulbind
description: Returns a soulbind by ID.
tags:
- Covenant API
x-source: https://community.developer.battle.net/documentation/world-of-warcraft/game-data-apis
parameters:
- name: soulbindId
in: path
required: true
description: The ID of the soulbind.
schema:
type: integer
default: 1
- name: namespace
in: query
required: true
description: The namespace to use to locate this document.
schema:
type: string
default: static-us
- name: locale
in: query
required: false
description: The locale to reflect in localized data.
schema:
type: string
default: en_US
responses:
'200':
description: Successful response (response schema not published in the reference).
/data/wow/covenant/conduit/index:
get:
operationId: conduitIndex
summary: Conduit Index
description: Returns an index of conduits.
tags:
- Covenant API
x-source: https://community.developer.battle.net/documentation/world-of-warcraft/game-data-apis
parameters:
- name: namespace
in: query
required: true
description: The namespace to use to locate this document.
schema:
type: string
default: static-us
- name: locale
in: query
required: false
description: The locale to reflect in localized data.
schema:
type: string
default: en_US
responses:
'200':
description: Successful response (response schema not published in the reference).
/data/wow/covenant/conduit/{conduitId}:
get:
operationId: conduit
summary: Conduit
description: Returns a conduit by ID.
tags:
- Covenant API
x-source: https://community.developer.battle.net/documentation/world-of-warcraft/game-data-apis
parameters:
- name: conduitId
in: path
required: true
description: The ID of the conduit.
schema:
type: integer
default: 1
- name: namespace
in: query
required: true
description: The namespace to use to locate this document.
schema:
type: string
default: static-us
- name: locale
in: query
required: false
description: The locale to reflect in localized data.
schema:
type: string
default: en_US
responses:
'200':
description: Successful response (response schema not published in the reference).
components:
securitySchemes:
oauth2:
type: oauth2
description: Documented at https://community.developer.battle.net/documentation/guides/using-oauth
flows:
clientCredentials:
tokenUrl: https://oauth.battle.net/token
scopes: {}
authorizationCode:
authorizationUrl: https://oauth.battle.net/authorize
tokenUrl: https://oauth.battle.net/token
scopes:
openid: OpenID Connect
wow.profile: World of Warcraft profile
sc2.profile: StarCraft II profile
d3.profile: Diablo III profile