---
updatedAt: 2025-06-02T21:23:00.000Z
agentTools:
  projectIndex: https://en-doc.trustdecision.com/llms.txt
---

# International Phone Pro

### API Format

#### Base URL

* Singapore: <https://sg.apitd.net/verification/persona/phone/pro/v1>
* America: <https://us.apitd.net/verification/persona/phone/pro/v1>
* Germany: <https://de.apitd.net/verification/persona/phone/pro/v1>

#### API

| **URL**                                          | **Request Methods** | **Content-Type** | **Output Format** | **Character Set** |
| ------------------------------------------------ | ------------------- | ---------------- | ----------------- | ----------------- |
| api-base-url?partner\_code=xxx\&partner\_key=xxx | POST                | application/json | JSON              | UTF-8             |

example: <https://sg.apitd.net/verification/persona/phone/pro/v1?partner_code=test_code&partner_key=test_key>

##### Authentication

| Parameter     | Type   | Description  | Required/Optional | Notes          |
| ------------- | ------ | ------------ | ----------------- | -------------- |
| partner\_code | String | Partner Code | required          | assigned by TD |
| partner\_key  | String | Partner Key  | required          | assigned by TD |

#### Request

| **Parameter** | **Type** | **Description** | **Required/Optional** | **Notes**                                                                          |
| ------------- | -------- | --------------- | --------------------- | ---------------------------------------------------------------------------------- |
| country\_code | Integer  | Country Code    | required              | Compliant with ITU E.164 standard, without '+ sign', without prefix 0, example: 86 |
| phone\_number | String   | Phone Number    | required              | without '+ sign'                                                                   |

#### Request Example

```json
{
    "country_code": 86,
    "phone_number": "18700001111"
}
```

#### Response Parameter

<Table>
  <thead>
    <tr>
      <th>
        **Parameter**
      </th>

      <th>
        **Type**
      </th>

      <th>
        **Description**
      </th>

      <th>
        **Notes**
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        code
      </td>

      <td>
        Integer
      </td>

      <td>
        API Status Code
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        message
      </td>

      <td>
        String
      </td>

      <td>
        Status Message
      </td>

      <td>
        specific abnormal reasons will be provided if the API is abnormal
      </td>
    </tr>

    <tr>
      <td>
        sequence\_id
      </td>

      <td>
        String
      </td>

      <td>
        Unique ID of Response
      </td>

      <td>
        A unique ID used to mark each request
      </td>
    </tr>

    <tr>
      <td>
        country\_id
      </td>

      <td>
        String
      </td>

      <td>
        Country ID
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        country
      </td>

      <td>
        String
      </td>

      <td>
        Country
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        province
      </td>

      <td>
        String
      </td>

      <td>
        Province
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        city
      </td>

      <td>
        String
      </td>

      <td>
        City
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        operator
      </td>

      <td>
        String
      </td>

      <td>
        Operator
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        phone\_type
      </td>

      <td>
        String
      </td>

      <td>
        Phone Type
      </td>

      <td>
        enumeration:\
        fixed\_line\
        mobile\
        prepaid\
        toll\_free\
        voip\
        pager\
        payphone\
        invalid\
        restricted\_premium\
        personal\
        voicemail\
        other
      </td>
    </tr>

    <tr>
      <td>
        risk\_score
      </td>

      <td>
        Integer
      </td>

      <td>
        Risk Score
      </td>

      <td>
        range: 0 - 100
      </td>
    </tr>
  </tbody>
</Table>

**API Status Code**

| **code** | **Description**              |
| -------- | ---------------------------- |
| 200      | Success                      |
| 301      | Service not purchased        |
| 302      | Traffic blocked              |
| 303      | Traffic insufficient         |
| 304      | Service expired              |
| 305      | Daily maximum volume reached |
| 9600     | System error                 |
| 9606     | Illegal parameter            |

#### Response Example

```json
{
  "code": 200,
  "message": "",
  "sequence_id": "1648777165770866F82AC7F326307055",
  "country_id": "CN",
  "country": "China",
  "province": "",
  "city": "Countrywide",
  "operator": "China Mobile",
  "phone_type": "mobile",
  "risk_score": 30
}
```