PHPackages                             quicreatdev/vatflow-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. quicreatdev/vatflow-php

ActiveLibrary[API Development](/categories/api)

quicreatdev/vatflow-php
=======================

Official PHP wrapper for the VatFlow API (EU VAT validation & monitoring)

v1.0.4(4mo ago)05MITPHP

Since Mar 1Pushed 4mo agoCompare

[ Source](https://github.com/Baptiste-Pignol/vatflow-php)[ Packagist](https://packagist.org/packages/quicreatdev/vatflow-php)[ RSS](/packages/quicreatdev-vatflow-php/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (1)Versions (6)Used By (0)

VatFlow PHP SDK
===============

[](#vatflow-php-sdk)

The official PHP client for the [VatFlow - EU VAT & Company Monitor](https://rapidapi.com/BaptistePignol/api/vatflow-eu-vat-company-monitor) API on RapidAPI.

VatFlow allows you to instantly validate European VAT numbers via VIES, enrich French company profiles (financials, executives, UBOs), and set up webhooks to monitor businesses for critical status changes.

Requirements
------------

[](#requirements)

- PHP 7.4 or higher
- Composer
- A RapidAPI account and API key

Installation
------------

[](#installation)

You can install the package via Composer:

```
composer require quicreatdev/vatflow-php
```

Quick Start
-----------

[](#quick-start)

To use the API, you need your RapidAPI key. You can find it in your RapidAPI Studio dashboard after subscribing to the VatFlow API.

```
require 'vendor/autoload.php';

use VatFlow\VatFlowClient;

// Initialize the client
$client = new VatFlowClient('YOUR_RAPIDAPI_KEY');
```

Usage
-----

[](#usage)

All methods return a standard PHP array decoded from the JSON response. You can check the `success` key to determine if the API call was successful.

### 1. Validate and Enrich a VAT Number

[](#1-validate-and-enrich-a-vat-number)

The `validate` method checks a VAT number and retrieves the company data.

**Built-in Auto-Retry:** By default, this SDK includes a robust auto-retry mechanism. If the government server (VIES) or the network experiences a temporary failure (HTTP 5xx), the client will automatically wait and retry up to 3 times before failing.

```
$vatNumber = 'FR14652014051';
$maxCacheDays = 7; // Request data no older than 7 days (default)
$autoRetry = true; // Automatically retry on 5xx network errors (default)

$response = $client->validate($vatNumber, $maxCacheDays, $autoRetry);

if ($response['success']) {
    echo "Company Name: " . $response['data']['name'] . "\n";
    echo "Address: " . $response['data']['address'] . "\n";
    echo "Is Valid: " . ($response['data']['is_valid'] ? 'Yes' : 'No') . "\n";
} else {
    echo "Error: " . $response['error'];
}
```

### 2. Subscribe to Webhook Alerts

[](#2-subscribe-to-webhook-alerts)

Register a webhook URL to be notified proactively if a company's status or data changes.

```
$vatNumber = 'FR14652014051';
$webhookUrl = 'https://api.yourdomain.com/webhooks/vatflow';

$response = $client->subscribeWebhook($vatNumber, $webhookUrl);

if ($response['success']) {
    echo "Subscribed! Subscription ID: " . $response['data']['subscription_id'];
}
```

### 3. List Active Webhooks

[](#3-list-active-webhooks)

Retrieve a list of all VAT numbers you are currently monitoring.

```
$response = $client->listWebhooks();

if ($response['success']) {
    echo "You have " . $response['count'] . " active webhooks.\n";
    print_r($response['data']);
}
```

### 4. Delete a Webhook

[](#4-delete-a-webhook)

Unsubscribe from alerts for a specific VAT number.

```
$vatNumber = 'FR14652014051';
$subscriptionId = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890';

$response = $client->deleteWebhook($vatNumber, $subscriptionId);

if ($response['success']) {
    echo "Webhook successfully deleted.";
}
```

Error Handling
--------------

[](#error-handling)

The client handles JSON decoding and basic network exceptions. If a request fails at the API level (e.g., invalid VAT format, missing parameters, or exceeding your RapidAPI quota), the method will return an array with `success` set to `false` and an `error` message.

```
array(3) {
  ["success"] => bool(false)
  ["error"] => string(60) "The VAT number format is invalid for this country."
  ["status_code"] => int(400) // Provided for network or severe API errors
}
```

License
-------

[](#license)

This project is licensed under the MIT License.

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance77

Regular maintenance activity

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

5

Last Release

124d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/489aac483a95881d7bb9c5d805b1f121b6c45f323ab4bf70d652f7d72a9af2fb?d=identicon)[Baptiste-Pignol](/maintainers/Baptiste-Pignol)

---

Top Contributors

[![Baptiste-Pignol](https://avatars.githubusercontent.com/u/5666709?v=4)](https://github.com/Baptiste-Pignol "Baptiste-Pignol (6 commits)")

### Embed Badge

![Health badge](/badges/quicreatdev-vatflow-php/health.svg)

```
[![Health](https://phpackages.com/badges/quicreatdev-vatflow-php/health.svg)](https://phpackages.com/packages/quicreatdev-vatflow-php)
```

###  Alternatives

[statamic/cms

The Statamic CMS Core Package

4.8k3.6M986](/packages/statamic-cms)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3741.3M46](/packages/tencentcloud-tencentcloud-sdk-php)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k656.1k38](/packages/neuron-core-neuron-ai)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

273.0k](/packages/eslazarev-wildberries-sdk)[avalara/avataxclient

Client library for Avalara's AvaTax suite of business tax calculation and processing services. Uses the REST v2 API.

528.5M7](/packages/avalara-avataxclient)[files.com/files-php-sdk

Files.com PHP SDK

2481.1k](/packages/filescom-files-php-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)