VI | EN
Message us on Messenger
Developer resources

Get the TikTok Shop exclusive authorization status of an ad account — TikTok Business API

Get the TikTok Shop exclusive authorization status of an ad account · call it through Quantri360 with one API key for your own accounts / assets that you connected and authorized — 360 handles request signing and refreshing the authorization you granted.

Get the TikTok Shop exclusive authorization status of an ad account

GET/gmv_max/exclusive_authorization/get/Via 360: GET https://partner.quantri360.com/v1/tiktok_business/gmv_max/exclusive_authorization/get/
Description

Use this endpoint to check whether an ad account is exclusively authorized to create GMV Max Campaigns for a specific TikTok Shop.

Request

Endpoint

GET https://partner.quantri360.com/v1/tiktok_business/gmv_max/exclusive_authorization/get/

Authentication & shop

NameInTypeSampleDescription
AuthorizationheaderheaderBearer q360_live_ab12cd34_…Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand.
platform_shop_idquerystring7000000000000000001Tài sản TikTok Business đã kết nối — "Mã tài sản" ở trang Nền tảng hoặc GET /v1/platforms (tài khoản quảng cáo cho Marketing API, tài khoản TikTok cho Organic / Messaging). Có thể bỏ khi chỉ kết nối một tài sản.

Request parameters

NameInTypeRequiredSampleDescription
store_idquerystringYesThe ID of the TikTok Shop. To obtain a TikTok Shop that is available for GMV Max Campaigns, use /gmv_max/store/list/ and confirm that the returned is_gmv_max_available is true.
store_authorized_bc_idquerystringYesID of the Business Center that is authorized to access the TikTok Shop (store_id).

Request examples

curl -s "https://partner.quantri360.com/v1/tiktok_business/gmv_max/exclusive_authorization/get/?store_id=&store_authorized_bc_id=" \
  -H "Authorization: Bearer $KEY"
Python
import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/tiktok_business/gmv_max/exclusive_authorization/get/",
    params={
        "store_id": "",
        "store_authorized_bc_id": ""
    },
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=60,
)
print(r.status_code)
print(r.json())
Node.js
const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/tiktok_business/gmv_max/exclusive_authorization/get/');
for (const [k, v] of Object.entries({"store_id":"","store_authorized_bc_id":""})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
  method: 'GET',
  headers: { Authorization: `Bearer ${KEY}` },
});
console.log(r.status, await r.json());
PHP
<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/tiktok_business/gmv_max/exclusive_authorization/get/' . '?' . http_build_query(['store_id' => '', 'store_authorized_bc_id' => '']);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key]);
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;

Response

Response fields (as returned by TikTok Business)

NameTypeSampleDescription
codenumberResponse code. For the complete list of response codes and descriptions, see Appendix-Return Code.
messagestringResponse message. For details, see Appendix - Return Codes.
request_idstringThe log ID of a request, which uniquely identifies the request.
dataobjectReturned data.
store_idstringThe ID of the TikTok Shop.
advertiser_idstringThe ID of the ad account.
authorization_statusstringThe status of exclusive authorization for the ad account to create GMV Max ads for the TikTok Shop. Enum values: - `EFFECTIVE`: The ad account is currently granted exclusive GMV Max authorization. - `INEFFECTIVE`: The ad account was granted exclusive GMV Max authorization but the authorization has been cancelled. - `UNAUTHORIZED`: The ad account has never been granted GMV Max exclusive authorization.
advertiser_namestringThe name of the ad account. Note: When `authorization_status` is `UNAUTHORIZED`, this field is not returned.
advertiser_statusstringThe status of the ad account. Enum values: - `STATUS_ENABLE`: Approved. - `STATUS_CONFIRM_FAIL`: Not approved. - `STATUS_PENDING_CONFIRM`: In review. - `STATUS_LIMIT`: Suspended. - `STATUS_CONTRACT_PENDING`: Contract has not taken effect. - `STATUS_DISABLE`: Disabled. - `STATUS_PENDING_CONFIRM_MODIFY`: Modifications pending review. - `STATUS_PENDING_VERIFIED`: Pending verification. - `STATUS_SELF_SERVICE_UNAUDITED`: Pending verification of qualifications for the self-service account. - `STATUS_WAIT_FOR_BPM_AUDIT`: Pending CRM system review. - `STATUS_CONFIRM_FAIL_END`: CRM system review failed. - `STATUS_CONFIRM_MODIFY_FAIL`: Review of modifications failed. Note: When `authorization_status` is `UNAUTHORIZED`, this field is not returned.
identity_idstringReturned only when an official TikTok account is set for the TikTok Shop. The ID of the identity associated with the official TikTok account for the TikTok Shop.

Response sample

HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "advertiser_id": "{{advertiser_id}}",
        "advertiser_name": "{{advertiser_name}}",
        "advertiser_status": "STATUS_ENABLE",
        "authorization_status": "EFFECTIVE",
        "identity_id": "{{identity_id}}",
        "store_id": "{{store_id}}"
    }
}

Get started

  1. Sign up for Partner
  2. Enable a data type of the Ads (Marketing API) group on the platform page
  3. Create an API key (tick the TikTok Business channel)
  4. Call it as in the examples above