Search Responsible Persons

POST

/product/202501/compliance/responsible_persons/search

Retrieve a list of responsible persons in the EU languages supported by TikTok Shop based on their ID or keywords. When creating a product with the Create Product API, pass a returned responsible person’s id as an element of responsible_person_ids. Target seller: Local sellers operating in EU countries

Authorizations

• accessToken

Parameters

Query Parameters

page_size

required

integer format: int64

>= 1 <= 100

The number of results to be returned per page. Valid range: [1-100]

page_token

string

An opaque token used to retrieve the next page of a paginated result set. Retrieve this value from the result of the next_page_token from a previous response. It is not needed for the first page.

Request Body

Media typeapplication/json

object

responsible_person_ids

Filter results by these responsible person IDs. Max IDs: The value of page_size

Array<string>

keyword

Filter results to show those that contain this keyword. Search scope: name, local_number, email Max length: 200 characters

Note: Provide either the responsible_person_ids or keyword; if both are provided, responsible_person_ids will take priority.

string

<= 200 characters

locales

The BCP-47 locale codes for displaying the responsible person information. Default: The locale of the seller’s registered business address. Possible values:

• de-DE
• en-IE
• es-ES
• fr-FR
• it-IT

Array<string>

Allowed values: de-DE en-IE es-ES fr-FR it-IT

Example

{
  "responsible_person_ids": [
    "66d3cbe4d9c8b09ddca932a7"
  ],
  "keyword": "John",
  "locales": [
    "en-IE",
    "es-ES"
  ]
}

Responses

200

Success

Media typeapplication/json

object

code

Status code; 0 means success.

integer format: int64

message

Success or failure message.

string

request_id

Request log ID.

string

data

object

responsible_persons

The list of responsible persons that meet the query conditions.

Array<object>

object

id

The responsible person ID in TikTok Shop.

string

regional_profiles

A list of contact details for the responsible person, presented in different languages for each supported EU country.

Array<object>

object

locale

The BCP-47 locale code representing the language used for specifying the responsible person information. Possible values:

• de-DE
• en-IE
• es-ES
• fr-FR
• it-IT

string

Allowed values: de-DE en-IE es-ES fr-FR it-IT

name

The responsible person name. Max length: 200 characters

string

<= 200 characters

email

The email address of the responsible person.

string

phone_number

The phone number of the responsible person.

object

country_code

The country code of the phone number, prefixed by a plus + symbol. E.g. +353 for Ireland. Only EU country codes are allowed. Max digits: 4

string

local_number

The local number. Length: 7 - 11 digits

string

address

The residential address of the responsible person.

object

street_address_line1

The detailed street address of the location, including the building number, street name, district, city, province, and any relevant details. Max length: 500 characters

string

<= 500 characters

street_address_line2

(Deprecated: This field is deprecated and will return an empty string. Please refer to street_address_line1 instead for the relevant details.)

An optional secondary line for additional address details, if necessary. Max length: 500 characters

string

<= 500 characters

district

(Deprecated: This field is deprecated and will return an empty string. Please refer to street_address_line1 instead for the district name.)

The district name. Max length: 500 characters

string

<= 500 characters

city

Deprecated: This field returns an empty string. Use street_address_line1 for the city name.

string

postal_code

The postal code. Max length: 500 characters

string

<= 500 characters

province

Deprecated: This field returns an empty string. Use street_address_line1 for the province, state, or region name.

string

country

The two letter ISO 3166 country code representing the country of the address. It must be an EU country.

string

total_count

The number of responsible persons that meet the query conditions.

integer format: int64

next_page_token

An opaque token used to retrieve the next page of a paginated result set. Provide this value in the page_token parameter of your request if the current response does not return all the results.

string

Example

{
  "code": 0,
  "data": {
    "responsible_persons": [
      {
        "id": "66d3cbe4d9c8b09ddca932a7",
        "regional_profiles": [
          {
            "locale": "en-IE",
            "name": "John Doe",
            "email": "john.doe@email.com",
            "phone_number": {
              "country_code": "+353",
              "local_number": "80915151"
            },
            "address": {
              "street_address_line1": "63 Cardiff Ln, Grand Canal Dock, Dublin City, Dublin",
              "street_address_line2": "-",
              "district": "-",
              "city": "-",
              "postal_code": "D02 HD23",
              "province": "-",
              "country": "IE"
            }
          }
        ]
      }
    ],
    "total_count": 26,
    "next_page_token": "66d3cbe3d9c8b09ddca932a1"
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}