China Game Data APIs Returning 403

Hello! I am testing an iOS app using the Blizzard API and I’d love to have support for all regions, but I’m having some trouble with the Chinese region.

I’m able to retrieve a Chinese OAuth access token using curl -u <id>:<secret> -d grant_type=client_credentials '':

HTTP/1.1 200 OK
Date: Wed, 26 Aug 2020 11:45:56 GMT
Server: Apache
X-Frame-Options: SAMEORIGIN
Retry-After: 600
Pragma: no-cache
Cache-Control: no-store
Vary: Accept-Encoding
Content-Encoding: gzip
Keep-Alive: timeout=10, max=4000
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Connection: keep-alive


I am then able to retrieve data from the Wow Token endpoint using curl -H "Authorization: Bearer <token>" ''

HTTP/1.1 200 OK
Battlenet-Schema-Revision: 2
Date: Wed, 26 Aug 2020 11:45:59 GMT
Server: Apache-Coyote/1.1
Last-Modified: Wed, 26 Aug 2020 11:29:02 GMT
Battlenet-Namespace: dynamic-cn
vary: accept-encoding
Cache-Control: public, max-age=300
Battlenet-Schema: token
content-type: application/json;charset=UTF-8
content-encoding: gzip
Transfer-Encoding: chunked
x-trace-traceid: af46d01d-f6cf-32d6-92ff-160971237f7b
x-trace-spanid: 162b02c1-d3f0-57d0-24e2-fa169a45094f
x-trace-parentspanid: 162b02c1-d3f0-57a0-24e2-fa169a45094f
x-frame-options: SAMEORIGIN
X-Content-Type-Options: nosniff
Connection: keep-alive


Every other Game Data API endpoint that I attempt to use in the Chinese region fails with a response like so:

HTTP/1.1 403 Forbidden
content-length: 0
x-trace-traceid: 7a8cf016-d850-37bf-9119-b125dd9dc34b
x-trace-spanid: 162b02c0-0e3b-d870-c079-fa169ae27127
x-trace-parentspanid: 162b02c0-0e3b-d780-c079-fa169ae27127
x-frame-options: SAMEORIGIN
X-Content-Type-Options: nosniff
Connection: keep-alive

I’ve tried realmSearch, realmIndex, connectedRealmIndex, itemSearch. These endpoints return 200s for every region except China (us, eu, kr, tw). I’ve re-read the Regionality documentation a few times, but I don’t see anything that explains this behavior.

Is this expected for China or am I doing something wrong?

1 Like

As I remember, CN endpoints available only for mainland China residents. I do not know exactly how did they track it (probably, account registration), but I also receive 403 Error as many other users, which are not from CN region itself.

FWIW, I have access to a Chinese account which has API credentials set up at, and even still, I get 403 forbidden from most WoW APIs.
1 Like


Currently, the available APIs for the CN region are listed on the documentation references individually from their “global” counterparts. This list is currently limited to include only the WoW Token Index (CN) API.

We recognize this distinction is missing from guides and documentation pertaining to regionality, and as always, will look for opportunities to improve upon our documentation moving forward.



Did you try with a non-china account but with a Chinese IP? There are VPN services you could use.

Just now I tried my previous example with a Chinese account with credentials set up at from a Chinese IP (China Telecom AS4812) and still got 403 forbidden.

Thanks for testing. Interesting. No idea on which grounds the access is denied then. Together with the blue post it seems that the Chinese API is disabled for everyone (apart from the wow token stuff).


I still encountered 403 Forbidden error for China servers’ data in 2022. Have we removed the limitation of this? I am curious why we don’t have access to China servers’ data except the token price.