CZ IČ/DIČ + VIES

Validate Czech IČO + DIČ checksums, fetch company data from ARES and verify EU VAT numbers via VIES – all in one API call.

原始信息汇总

CZ IČ/DIČ + VIES API 数据集概述

基本信息

• API名称: CZ IČ/DIČ + VIES
• 提供商: Dasky
• 类别: 商业软件
• 版本: v1 (current)
• 基础URL: https://cz-ico-api.onrender.com
• 定价:
  • Freemium: 免费使用，限制每秒1次请求
  • PRO: $5.00 / 月
  • ULTRA: $49.00 / 月

功能概述

验证捷克公司ID（IČO）和增值税ID（DIČ），从ARES注册表中自动填充公司数据，并通过VIES验证欧盟增值税号码。

端点列表

1. GET /validate_ico

• 描述: 检查8位数捷克公司ID的校验和。
• 查询参数:
  • ico (string, 必需): 8位数捷克公司ID。
• 响应示例: json { "ico": "27074358", "valid": true }

2. GET /validate_dic

• 描述: 检查CZ DIČ校验和（CZ + IČO）。
• 响应结构: 与/validate_ico相同（dic, valid）。

3. GET /lookup_ico

• 描述: 从ARES注册表中获取公司详细信息。

• 响应示例: json { "ico": "27074358", "name": "ALZA.CZ a.s.", "address": "Jankovcova 1522/53, 170 00 Praha 7-Holešovice" }

• 未找到IČO时返回404。

4. GET /check_vat

• 描述: 通过VIES验证欧盟增值税ID（返回交易者名称）。

• 响应示例: json { "dic": "CZ27074358", "valid": true, "trader_name": "ALZA.CZ a.s.", "country_code": "CZ", "request_date": "2025-07-02" }

• 状态码:

  • 200: VIES响应。
  • 400: DIČ格式错误或VIES SOAP错误。
  • 504: VIES在20秒内未响应。

错误响应

状态码	详情示例
400	Invalid IČO / Invalid CZ DIČ
404	Company not found
504	VIES timeout (20s)
500	Internal server error

快速开始示例

cURL

bash curl -G https://cz-ico-api.onrender.com/lookup_ico --data-urlencode ico=27074358

JavaScript (fetch)

javascript const url = https://cz-ico-api.onrender.com/check_vat?dic=CZ27074358; fetch(url) .then(r => r.json()) .then(console.log);

Python (requests)

python import requests, pprint r = requests.get(https://cz-ico-api.onrender.com/validate_ico, params={ico: 27074358}) pprint.pp(r.json())

变更日志

版本	日期	说明
1.0.0	2025-07-02	验证IČO/DIČ，ARES查找，欧盟VIES检查