VatFlow - EU VAT & Company Monitor

The ultimate B2B data API: Validate VATs, enrich company profiles, and get real-time webhook alerts.

--- ## 📖 Overview **VatFlow** goes beyond standard VAT validation. While most APIs simply tell you if a VAT number is valid, VatFlow provides a comprehensive suite for B2B compliance, KYC, and risk management. Powered by smart caching for lightning-fast responses and a robust webhook engine, VatFlow allows you to validate European VAT numbers (via VIES), enrich French company profiles with financial and executive data, and actively monitor your B2B customers for critical status changes. ## ✨ Key Features * **EU VAT Validation (VIES):** Instant verification of VAT numbers across all 27 EU Member States (plus Northern Ireland). * **Deep Data Enrichment (France):** Automatically resolves French VAT numbers into deep corporate profiles including exact legal form, financial data (revenue & net income), administrative status, and executives/UBOs. * **Smart Caching Engine:** Specify your own TTL (Time-To-Live). Repeated queries return in milliseconds, protecting you from VIES downtime and rate limits. * **Proactive Monitoring (Webhooks):** Subscribe to a VAT number and receive an instant `POST` request to your server if the company closes, changes its address, or modifies its legal status. --- ## 🚀 Top Use Cases ### 1. Automated B2B Billing (E-commerce & SaaS) Avoid tax compliance fines by ensuring your B2B customers have a valid VAT number before applying the reverse charge mechanism. Use the smart cache to instantly validate returning customers at checkout without latency. ### 2. KYC & Vendor Onboarding Speed up your onboarding process. When a user inputs their VAT number, automatically autofill their company name, exact headquarters address, and (for French entities) verify their executives and financial health. ### 3. Risk Management & CRM Automation Don't wait for an unpaid invoice to realize a client went bankrupt. Subscribe to webhook alerts for your top clients. If a company's administrative status changes to "Closed" or "Liquidated", VatFlow will immediately ping your ERP or CRM so you can freeze their credit line. --- ## 📦 Official SDKs (Wrappers) To make integration as fast as possible, VatFlow provides official, zero-dependency wrappers with **built-in auto-retry mechanisms** for the most popular backend languages. ### Node.js (npm) ```bash npm install vatflow ``` ```javascript const VatFlowClient = require('vatflow'); const client = new VatFlowClient('YOUR_RAPIDAPI_KEY'); // Validate and enrich a VAT number in one line const result = await client.validate('FR14652014051'); console.log(result.data.name); ``` ### PHP (Composer) ```bash composer require quicreatdev/vatflow-php ``` ```php require 'vendor/autoload.php'; use VatFlow\VatFlowClient; $client = new VatFlowClient('YOUR_RAPIDAPI_KEY'); $result = $client->validate('FR14652014051'); echo $result['data']['name']; ``` --- ## 💻 Raw Code Examples If you prefer not to use the SDKs, all endpoints require the RapidAPI authentication headers. RapidAPI automatically handles the injection of `X-RapidAPI-Key` and `X-RapidAPI-Host`. ### Validate & Enrich a VAT Number Use the `/vat` endpoint to check a VAT number. **Endpoint:** `GET https://vatflow-eu-vat-company-monitor.p.rapidapi.com/vat` **JavaScript (Fetch):** ```javascript const url = 'https://vatflow-eu-vat-company-monitor.p.rapidapi.com/vat?vat=FR14652014051&max_cache_days=7'; const options = { method: 'GET', headers: { 'x-rapidapi-key': 'YOUR_RAPIDAPI_KEY', 'x-rapidapi-host': 'vatflow-eu-vat-company-monitor.p.rapidapi.com' } }; try { const response = await fetch(url, options); const result = await response.json(); console.log(result); } catch (error) { console.error(error); } ``` **Python (Requests):** ```python import requests url = "https://vatflow-eu-vat-company-monitor.p.rapidapi.com/vat" querystring = {"vat": "FR14652014051", "max_cache_days": "7"} headers = { "x-rapidapi-key": "YOUR_RAPIDAPI_KEY", "x-rapidapi-host": "vatflow-eu-vat-company-monitor.p.rapidapi.com" } response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` ### Subscribe to Webhook Alerts Want to be notified if this company's data changes? Register a webhook. **Endpoint:** `POST https://vatflow-eu-vat-company-monitor.p.rapidapi.com/webhooks/subscribe` **cURL:** ```bash curl --request POST \ --url https://vatflow-eu-vat-company-monitor.p.rapidapi.com/webhooks/subscribe \ --header 'Content-Type: application/json' \ --header 'x-rapidapi-host: vatflow-eu-vat-company-monitor.p.rapidapi.com' \ --header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY' \ --data '{ "vat": "FR14652014051", "webhook_url": "https://api.yourdomain.com/webhooks/vatflow" }' ``` --- ## 🔔 Webhook Payload Example When VatFlow's nightly scanner detects a change in the company's profile (e.g., address change, invalid VAT, or closure), it will send a `POST` request to your `webhook_url` with the following structure: ```json { "event_type": "company.updated", "vat_number": "FR14652014051", "timestamp": "2026-03-01T02:15:00.000Z", "changes": { "old_data": { "is_valid": true, "address": "10 OLD STREET 75000 PARIS" }, "new_data": { "is_valid": true, "address": "14 NEW STREET 75000 PARIS" } } } ``` --- ## 🛠 Support & Limits * **Rate Limits:** Enforced by your chosen RapidAPI plan. Webhook limits apply per tier (Basic, Pro, Ultra). * **VIES Downtime:** The European Commission's VIES service experiences occasional downtime. VatFlow utilizes smart caching and automatic retry mechanisms to shield you from these outages as much as possible. * **Contact:** For enterprise plans, custom SLAs, or technical support, please contact us through the RapidAPI support tab.