实时
服务状态
集成前，请先查看实时服务运行状况和文档中说明的失败响应。
分类
身份与验证
API 端点
1
主要功能
4
常见问题解答
4
被这些公司的人员使用
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。
OpenAPI
API 资料
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
API 密钥
受保护访问
认证端点使用 API 密钥，并在调用前清楚显示积分成本。
10,000
免费额度
从每月 10,000 积分开始，只有在用量增长时再升级。
这个 API 可以帮你交付什么
把此页面当作生产集成简报：端点、示例、响应结构，以及把 DomScan 接入产品所需的工作流组件。
把域名检查、DNS 情报、风险信号或数据增强嵌入注册、搜索和内部工具。
用计划任务、告警和可复现的调查步骤替代重复的人工查询。
使用可预测字段、已记录的状态码和积分成本，而不是抓取供应商页面。
通过 OpenAPI、SDK、Postman 或 MCP 为代理、仪表板、SOAR 剧本和 CRM 提供数据。
集成流程
从第一次请求到可重复生产使用的简单路径。
一次认证
使用文档中的请求头发送 API 密钥，并在服务之间保持请求一致。
用示例查询
从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。
运行和监控
使用状态码、积分成本和响应字段构建重试、日志和告警。
开发者工具包
从此页面跳转到机器可读文档、请求集合、SDK 或代理工具。
参数和响应映射
在把端点接入客户端前，快速查看输入、输出字段和状态码。
参数
vatcountryrequester
响应示例
vat_numbercountry_codestatusvalidreasonformat_validchecksumregistered_nameregistered_addressname_discloseddetailsdetails.vat_registered
HTTP 状态码
200400401402429
API 端点
GET
/v1/vat/validate
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。
实时
服务状态
集成前，请先查看实时服务运行状况和文档中说明的失败响应。
OpenAPI
API 资料
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
API 密钥
受保护访问
认证端点使用 API 密钥，并在调用前清楚显示积分成本。
10,000
免费额度
从每月 10,000 积分开始，只有在用量增长时再升级。
主要功能
登记系统实时核查
有效性来自您发起请求时的官方登记系统，而不是缓存列表，也不是仅做格式检查。
核查凭证
将您自己的欧盟 VAT 号码作为 requester 发送，即可获得咨询编号，您可以保存它，作为开具反向征税发票的证据。
先查格式和校验位
格式错误的号码无需调用登记系统即被拒绝，并且会报告每个受支持国家的校验位结果。
未知，而非无效
当某国登记系统离线或繁忙时，结果为未知并附上原因，且该请求不会收费。
请求示例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/vat/validate?vat=NO923609016MVA"响应示例
{
"vat_number": "NO923609016MVA",
"country_code": "NO",
"status": "valid",
"valid": true,
"reason": "active_vat_registration",
"format_valid": true,
"checksum": "valid",
"registered_name": "EQUINOR ASA",
"registered_address": "Forusbeen 50, 4035 STAVANGER, Norge",
"name_disclosed": true,
"details": { "vat_registered": true, "vat_registered_since": "1989-07-01", "bankrupt": false }
}常见问题解答
覆盖哪些国家？
27 个欧盟国家、北爱尔兰和挪威均可实时核查。英国、瑞士和澳大利亚的号码仅检查格式和校验位，因为这些登记系统不提供免费的公开查询。
为什么缺少企业名称？
德国和西班牙等部分国家不会通过欧盟登记系统公开名称和地址。此时结果会将 name_disclosed 设为 false。
“未知”是什么意思？
登记系统未能给出答复：可能不可用、繁忙或响应太慢。请稍后重试。结果为未知的请求会退还额度。
每次调用消耗多少额度？
每次核查消耗一个额度。结果为未知的核查不收费。
相关工具和资源
HTTP 状态码
我们明确列出了客户端应处理的 HTTP 状态码，帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
成功
200
请求成功
请求错误
400
参数无效
未授权
401
API 密钥或会话缺失或无效。
需要付款
402
没有足够额度来执行此请求。
请求过多
429
超出速率限制