VI | EN
Message us on Messenger
Developer resources

Check the verification status of your account — TikTok Business API

Check the verification status of your 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.

Check the verification status of your account

GET/account/verification/status/Via 360: GET https://partner.quantri360.com/v1/tiktok_business/account/verification/status/
Description

Use this endpoint to retrieve the current verification status of your Business Center or ad account.

Request

Endpoint

GET https://partner.quantri360.com/v1/tiktok_business/account/verification/status/

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
bc_idquerystringNoEither advertiser_id or bc_id has to be set. The ID of the Business Center account that you want to check the verification status for. To retrieve the list of Business Centers that you can access, use /bc/get/.

Request examples

curl -s "https://partner.quantri360.com/v1/tiktok_business/account/verification/status/" \
  -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/account/verification/status/",
    params={},
    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/account/verification/status/');
for (const [k, v] of Object.entries({})) 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/account/verification/status/' . '?' . http_build_query([]);
$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 Codes.
messagestringResponse message. For details, see Appendix - Return Codes.
request_idstringThe log ID of the request, which uniquely identifies a request.
dataobjectReturned data.
qualification_idstringThe qualification image ID of the verification document you submitted for your Business Center or ad account. If you want to create Organization Accounts within an Agency Business Center, you can pass this ID to `qualification_id` in /bc/oa/create/.
verification_statusstringThe current verification status of the ad account or Business Center account. Enum values: - `NOT_SUBMITTED`: The verification has not been submitted. - `REVIEWING`: The verification is currently under review. - `VERIFIED`: The account has been verified successfully. - `FAILED`: The verification has failed. - `EXPIRED`: The verification has expired.
rejection_reasonstringReturned only when `verification_status` is `FAILED`. The reason for rejecting the verification request. For common rejection reasons and troubleshooting suggestions, see List of common rejection reasons and suggestions for verification failures.
audit_timestringThe time when the review of the verification request was completed, in the format of `YYYY-MM-DD HH:MM:SS` (UTC+0 time). Example: `2026-07-08 10:30:58`.

Response sample

HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "audit_time": "2026-07-08 10:30:58",
        "qualification_id": "{{qualification_id}}",
        "rejection_reason": "{{rejection_reason}}",
        "verification_status": "FAILED"
    }
}

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