# CZ IČ / DIČ + VIES API 🇨🇿 Validate Czech company IDs (IČO) & VAT IDs (DIČ), autofill firm data from the ARES register — and verify EU VAT numbers via VIES, all in one call. --- ## Base URL ``` https://cz-ico-api.onrender.com ``` --- ## Endpoints | Method | Path | Description | |--------|----------------|-------------| | **GET** | `/validate_ico` | Check 8-digit IČO checksum | | **GET** | `/validate_dic` | Check CZ DIČ checksum (`CZ` + IČO) | | **GET** | `/lookup_ico` | Fetch company details from **ARES** registry | | **GET** | `/check_vat` | Validate EU VAT ID via **VIES** (returns trader name) | --- ### 1 `/validate_ico` ```http GET /validate_ico?ico=27074358 ``` | Query param | Type | Required | Description | |-------------|--------|----------|-----------------------| | `ico` | string | ✔︎ | 8-digit Czech company ID |

200 OK

```json { "ico": "27074358", "valid": true } ```

--- ### 2 `/validate_dic` ```http GET /validate_dic?dic=CZ27074358 ``` Returns the same structure (`dic`, `valid`). --- ### 3 `/lookup_ico` – ARES lookup ```http GET /lookup_ico?ico=27074358 ```

200 OK

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

*If the IČO is not found, returns **404**.* --- ### 4 `/check_vat` – EU VIES validation ```http GET /check_vat?dic=CZ27074358 ```

200 OK

```json { "dic": "CZ27074358", "valid": true, "trader_name": "ALZA.CZ a.s.", "country_code": "CZ", "request_date": "2025-07-02" } ```

| Possible status | Meaning | |-----------------|---------| | **200** – `valid: true/false` | VIES responded | | **400** | Bad DIČ format or VIES SOAP error | | **504** | VIES did not respond within 20 s | --- ## Error responses | Status | Detail (example) | |--------|-------------------------| | **400** | `Invalid IČO` / `Invalid CZ DIČ` | | **404** | `Company not found` | | **504** | `VIES timeout (20s)` | | **500** | Internal server error | --- ## Quick-start examples ### cURL ```bash curl -G 'https://cz-ico-api.onrender.com/lookup_ico' \ --data-urlencode ico=27074358 ``` ### JavaScript (fetch) ```js 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()) ``` --- ## Changelog | Version | Date | Notes | |---------|------|-------| | **1.0.0** | 2025-07-02 | Validate IČO/DIČ, ARES lookup, EU VIES check | *Happy validating!*