获取商务中心中已有的资质信息

您可以使用本接口获取商务中心中已有资质的信息。

从返回中获取 qualification_id 后，您可将此字段传入 /bc/advertiser/create/ 的 qualification_id 复用该资质创建广告账户。

使用前需知

需确保您已在 /bc/advertiser/create/ 中传入 qualification_info 创建了广告账户。所指定的 qualification_info 将用于生成 qualification_id。若您创建广告账户时未指定 qualification_info，将无法获取 qualification_id 从而复用资质。
需确保您对该商务中心有管理员权限。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/bc/advertiser/qualification/get/

方法 GET

Header

|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|

参数

|字段|类型|描述|
|---|---|---|
| bc_id {必填}| string | 商务中心 ID。<br><br> 若想获取可访问的商务中心，可使用 [/bc/get/](1737115687501826.html)。 |
|filtering|object|筛选条件。 |
#|verified|boolean|资质是否经审核。|
|page|int|当前页数，默认值: `1`，取值范围: ≥ 1。|
|page_size|int|分页大小，默认值: `10`，取值范围: 1-100。|

示例

(code curl http)
curl --location -g --request GET 'https://business-api.tiktok.com/open_api/v1.3/bc/advertiser/qualification/get/?bc_id={{bc_id}}&filtering={"verified": true}' \
--header 'Access-Token: {{Access-Token}}'
(/code)

|字段|类型|描述|
|---|---|---|
|code |number|返回码，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|data|object|返回数据。|
#|qualifications|object[]|资质信息。 |
##|qualification_id|string|资质ID。|
##|company_name|string|广告账户公司名称。|
##|status|string|资质审核状态。枚举值：`VERIFIED` , `UNVERIFIED`。|
##|owner_advertiser_id|string|持有资质的广告账户ID。 |
##|linked_advertiser_count|int|关联的广告账户的数量。|
##|region_code|string|国家或地区代码。例如，“DE”。|
#|page_info|object| 分页信息|
##|page|number| 当前页码|
##|page_size| number | 页大小|
##|total_number| number | 总结果数 |
##|total_page| number | 总页数|

示例

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "page_info": {
            "page_size": 10,
            "page": 1,
            "total_page": 1,
            "total_number": 4
        },
        "qualifications": [
            {
                "status": "VERIFIED",
                "region_code": "US",
                "linked_advertiser_count": 1,
                "qualification_id": "{{qualification_id}}",
                "owner_advertiser_id": "{{owner_advertiser_id}}",
                "company_name": "{{company_name}}"
            },
            {
                "status": "VERIFIED",
                "region_code": "US",
                "linked_advertiser_count": 3,
                "qualification_id": "{{qualification_id}}",
                "owner_advertiser_id": "{{owner_advertiser_id}}",
                "company_name": "{{company_name}}"
            },
            {
                "status": "VERIFIED",
                "region_code": "US",
                "linked_advertiser_count": 1,
                "qualification_id": "{{qualification_id}}",
                "owner_advertiser_id": "{{owner_advertiser_id}}",
                "company_name": "{{company_name}}"
            },
            {
                "status": "VERIFIED",
                "region_code": "US",
                "linked_advertiser_count": 1,
                "qualification_id": "{{qualification_id}}",
                "owner_advertiser_id": "{{owner_advertiser_id}}",
                "company_name": "{{company_name}}"
            }
        ]
    }
}
(/code)