跳转到主要内容
GET
/
v1
/
validate
VAT 验证端点
curl --request GET \
  --url https://vat.cleariflow.com/v1/validate/
{
    "company": {
        "address": "8 RUE DE LONDRES\n75009 PARIS",
        "name": "EURL GOOGLE FRANCE"
    },
    "country": {
        "code": "FR",
        "name": "France"
    },
    "valid": true,
    "vat_number": "FR64443061841"
}

​
快速开始

​
基础 URL

https://vat.cleariflow.com/v1/validate/

​
验证端点

validate 端点需要您的唯一 API 密钥和要检查的 VAT 号码： 
https://vat.cleariflow.com/v1/validate/
? api_key = YOUR_UNIQUE_API_KEY
& vat_number = FR64443061841
此成功请求返回与已验证 VAT 号码关联的全面公司信息： 
{
    "company": {
        "address": "8 RUE DE LONDRES\n75009 PARIS",
        "name": "EURL GOOGLE FRANCE"
    },
    "country": {
        "code": "FR",
        "name": "France"
    },
    "valid": true,
    "vat_number": "FR64443061841"
}

​
请求参数

​
api_key
String
必填
您的唯一 API 密钥。请注意，每个用户为每个 Cleariflow API 拥有独立的 API 密钥，因此您的 VAT 验证与税率 API 密钥无法用于 IP 地理定位 API，例如。
​
vat_number
String
必填
要验证的 VAT 号码。

​
响应参数

API 响应以通用、轻量的 JSON 格式 返回。
​
vat_number
String
要验证的 VAT 号码。
​
valid
Boolean
若提交的 VAT 号码有效则为 true。
​
company
Object
包含公司信息的对象。
​
company.name
String
与 VAT 号码关联的公司名称。
​
company.address
String
与 VAT 号码关联的公司地址。
​
country
Object
包含国家信息的对象。
​
country.code
String
与 VAT 号码关联国家的两字母 ISO 3166-1 alpha-2 代码。
​
country.name
String
与 VAT 号码关联国家的名称。