{"id":36427119,"url":"https://github.com/wtx-labs/vies-api-client-java","last_synced_at":"2026-01-11T18:01:24.998Z","repository":{"id":324725626,"uuid":"1098234847","full_name":"wtx-labs/vies-api-client-java","owner":"wtx-labs","description":"The VIES API Client for Java provides simple and efficient access to the VAT Information Exchange System (VIES) for validating EU VAT numbers. It enables seamless integration with the VIES service to verify VAT registration status across EU member states using a clean and easy-to-use interface.","archived":false,"fork":false,"pushed_at":"2025-11-17T13:52:42.000Z","size":54,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"release/1.0.0","last_synced_at":"2025-11-17T15:22:22.383Z","etag":null,"topics":["api","api-client","api-rest","european-union","european-vat-numbers","financial","goverment","integration","integrations","java","rest","rest-api","vat","vat-information-exchange","vat-information-exchange-system","vat-number","vat-validation","vies","vies-api"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wtx-labs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-17T12:37:22.000Z","updated_at":"2025-11-17T13:53:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/wtx-labs/vies-api-client-java","commit_stats":null,"previous_names":["wtx-labs/vies-api-client-java"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/wtx-labs/vies-api-client-java","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtx-labs%2Fvies-api-client-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtx-labs%2Fvies-api-client-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtx-labs%2Fvies-api-client-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtx-labs%2Fvies-api-client-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wtx-labs","download_url":"https://codeload.github.com/wtx-labs/vies-api-client-java/tar.gz/refs/heads/release/1.0.0","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtx-labs%2Fvies-api-client-java/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28316974,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-11T14:58:17.114Z","status":"ssl_error","status_checked_at":"2026-01-11T14:55:53.580Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","api-client","api-rest","european-union","european-vat-numbers","financial","goverment","integration","integrations","java","rest","rest-api","vat","vat-information-exchange","vat-information-exchange-system","vat-number","vat-validation","vies","vies-api"],"created_at":"2026-01-11T18:01:20.160Z","updated_at":"2026-01-11T18:01:24.961Z","avatar_url":"https://github.com/wtx-labs.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VIES API Client for Java\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Java Version](https://img.shields.io/badge/Java-8%2B-blue)](https://www.java.com)\n[![Maven Central](https://img.shields.io/maven-central/v/pl.wtx.vies/vies-api-client?label=Maven%20Central\u0026logo=apache-maven\u0026color=blue)](https://mvnrepository.com/artifact/pl.wtx.vies/vies-api-client)\n\nA lightweight Java client for the public [VIES REST API](https://ec.europa.eu/taxation_customs/vies/) that validates EU VAT numbers and reports the availability of national VAT systems. 🚀\n\nThis client gives you type-safe access to the official VIES endpoints so you can:\n- Check VAT numbers for any EU member state\n- Exercise the built‑in VIES test service\n- Monitor the status of individual tax administrations\n\n## ✨ Why choose this client?\n\n- 💡 **Type-safe Java API** – generated models and operations for each VIES REST endpoint\n- ⚙️ **Zero-auth configuration** – VIES is a public API, so no credentials are required\n- 📦 **OkHttp + Gson stack** – customizable HTTP client with optional logging\n- ⚡ **Compatible with API specification** - based on official [API specification](https://ec.europa.eu/assets/taxud/vow-information/swagger_publicVAT.yaml)\n\n## 🎯 Currently implemented features\n\n- ✅ `checkVatNumber`\n  - Validate a VAT number in a selected member state\n  - Retrieve trader name/address and optional match indicators\n- ✅ `checkVatTestService`\n  - Hit the official VIES sandbox without touching production data\n  - Exercise request payloads used in certification\n- ✅ `checkStatus`\n  - List availability per member state\n  - Inspect VIES-wide operational status\n\n## 🚨 Project status\n\n\u003e ⚠️ **Note:** This is the first public release focused on VIES REST endpoints.  \n\u003e Feedback and contributions are very welcome!\n\n## 📦 Version information\n\n- **Current version**: `1.0.0`\n- **Supported API**: VIES REST (`/rest-api`)\n- **Java compatibility**: 8+\n\n## 🔓 License\n\n**MIT License**\n\nUse, modify, and distribute freely while keeping the original attribution.\n\n## 🚀 Quick start guide\n\n### 1️⃣ Installation\n\nClone and build from source:\n\n```bash\ngit clone https://github.com/wtx-labs/vies-api-client-java.git\ncd vies-api-client-java\nmvn clean install\n```\n\nAdd the artifact to your project:\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003epl.wtx.vies\u003c/groupId\u003e\n    \u003cartifactId\u003evies-api-client\u003c/artifactId\u003e\n    \u003cversion\u003e1.0.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n### 2️⃣ Java integration example\n\n```java\npackage pl.wtx.vies;\n\nimport pl.wtx.vies.api.client.PublicApi;\nimport pl.wtx.vies.api.client.invoker.ApiException;\nimport pl.wtx.vies.api.client.model.CheckVatRequest;\nimport pl.wtx.vies.api.client.model.CheckVatResponse;\n\n/**\n * The VIES (VAT Information Exchange System) API Client - Usage Demo\n * @author WTX Labs\n * @see https://github.com/wtx-labs/vies-api-client-java\n * @license MIT\n */\npublic class ViesApiClientUsageDemo {\n\n    private static final String BASE_PATH = \"https://ec.europa.eu/taxation_customs/vies/rest-api\";\n\n    public static void main(String[] args) {\n\n        System.out.println(\"\u003e\u003e\u003e Start running the ViesApiClientUsageDemo...\");\n\n        ViesApiClient apiClient = new ViesApiClient();\n        apiClient.setBasePath(BASE_PATH);\n\n        PublicApi publicApi = new PublicApi(apiClient);\n\n        try {\n\n            CheckVatRequest checkVatRequest = new CheckVatRequest();\n            checkVatRequest.setCountryCode(\"PL\");\n            checkVatRequest.setVatNumber(\"1234567890\");\n\n            CheckVatResponse checkVatResponse = publicApi.checkVatNumber(checkVatRequest);\n\n            System.out.println(\"Is VIES number valid: \" + checkVatResponse.getValid());\n            System.out.println(\"Name: \" + checkVatResponse.getName());\n            System.out.println(\"Address: \" + checkVatResponse.getAddress());\n\n        } catch (ApiException e) {\n            System.err.println(\"API Error: \" + e.getMessage());\n        }\n\n        System.out.println(\"\u003c\u003c\u003c The \u003c\u003c\u003c ViesApiClientUsageDemo has been finished.\");\n\n    }\n\n}\n```\n\n## 🔗 Get involved\n\n- ✨ Track issues: https://github.com/wtx-labs/vies-api-client-java/issues\n- 💡 Have ideas? Open an issue or PR – community contributions are welcome!\n- 🌟 Star the repo if this saves you time\n\n## 📊 Project statistics\n\n- 🚀 Fresh VIES-focused client\n- 🔄 Continuous improvements driven by OpenAPI updates\n- 👥 Maintained by WTX Labs\n\n## 🔍 Keywords\n\nvies java client, eu vat validation java, vies rest api java, vat information exchange system java, vat number check java, vies api client library, vies sdk java\n\n🚀 Happy coding! 😊  \n**Your WTX Labs Team** 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwtx-labs%2Fvies-api-client-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwtx-labs%2Fvies-api-client-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwtx-labs%2Fvies-api-client-java/lists"}