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(5mo ago)05MITPHP

Since Mar 1Pushed 5mo 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 1w ago

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

31

—

LowBetter than 65% of packages

Maintenance70

Regular maintenance activity

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity39

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

170d 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

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3661.3M49](/packages/tencentcloud-tencentcloud-sdk-php)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

353.6k](/packages/eslazarev-wildberries-sdk)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k832.6k55](/packages/neuron-core-neuron-ai)[files.com/files-php-sdk

Files.com PHP SDK

2482.9k](/packages/filescom-files-php-sdk)[volcengine/volcengine-php-sdk

119.5k](/packages/volcengine-volcengine-php-sdk)

PHPackages © 2026

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