https://github.com/conedevelopment/vies-php
VIES EU VAT number checker API.
https://github.com/conedevelopment/vies-php
Last synced: about 1 month ago
JSON representation
VIES EU VAT number checker API.
- Host: GitHub
- URL: https://github.com/conedevelopment/vies-php
- Owner: conedevelopment
- License: mit
- Created: 2025-12-09T07:48:42.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2026-01-26T05:08:16.000Z (6 months ago)
- Last Synced: 2026-02-14T02:31:27.077Z (5 months ago)
- Language: PHP
- Size: 70.3 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# VIES API PHP SDK
This is the contract for Vies on-the-Web endpoints. The checkVat service supports exact and approximate matching at the same time. In order to retrieve the requestIdentifier, the information about requesterMemberStateCode and requesterNumber have to be provided.
## Installation
### Requirements
- PHP 8.1+.
### Composer
```sh
composer require conedevelopment/vies-php
```
Then run `composer install`
## Usage
```php
use Cone\Vies\Client;
use Cone\Vies\Model\CheckVatRequest;
use Throwable;
$client = new Client;
try {
$response = $client->api()->checkVatNumber(new CheckVatRequest([
'countryCode' => 'HU',
'vatNumber' => '12345678',
]));
// Handle response
} catch (Throwable $e) {
// Handle exception, report to Sentry etc...
}
```
## API Endpoints
All URIs are relative to *https://ec.europa.eu/taxation_customs/vies/rest-api*
Class | Method | HTTP request | Description
------------ | ------------- | ------------- | -------------
*PublicApi* | [**checkStatus**](docs/Api/PublicApi.md#checkstatus) | **GET** /check-status | Check the status of each member states
*PublicApi* | [**checkVatNumber**](docs/Api/PublicApi.md#checkvatnumber) | **POST** /check-vat-number | Check a Vat Number for a specific country
*PublicApi* | [**checkVatTestService**](docs/Api/PublicApi.md#checkvattestservice) | **POST** /check-vat-test-service | Test the check vat service
## Models
- [CheckVatRequest](docs/Model/CheckVatRequest.md)
- [CheckVatResponse](docs/Model/CheckVatResponse.md)
- [CommonResponse](docs/Model/CommonResponse.md)
- [CountryStatus](docs/Model/CountryStatus.md)
- [ErrorWrapper](docs/Model/ErrorWrapper.md)
- [Status](docs/Model/Status.md)
- [StatusInformationResponse](docs/Model/StatusInformationResponse.md)
- [StatusInformationResponseVow](docs/Model/StatusInformationResponseVow.md)