PHPackages                             firebed/vat-registry - 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. firebed/vat-registry

ActivePackage[API Development](/categories/api)

firebed/vat-registry
====================

Business Registry Information Search

v2.0.3(2mo ago)221.2k↓25%4MITPHPPHP ^8.0

Since Jun 2Pushed 2mo ago3 watchersCompare

[ Source](https://github.com/firebed/vat-registry)[ Packagist](https://packagist.org/packages/firebed/vat-registry)[ RSS](/packages/firebed-vat-registry/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (6)Dependencies (2)Versions (13)Used By (0)

Search for Basic Business Registry Information
==============================================

[](#search-for-basic-business-registry-information)

Using this service, legal entities, legal persons, and natural persons with income from business activity can search for basic information in order to verify the tax or professional status of other legal entities, legal persons, or taxpayers/natural persons conducting business activity.

The system provides 3 ways to search for basic business registry information:

- Through the Basic Business Registry Information Search Service
- Through the Business Registry Service (ΓΕ.ΜΗ.)
- Through the VAT Information Exchange System (VIES) Service

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

[](#installation)

```
composer require firebed/vat-registry
```

Through the Basic Business Registry Information Search Service
--------------------------------------------------------------

[](#through-the-basic-business-registry-information-search-service)

This service allows searching all Greek VAT numbers. For the search, you will need a `username` and a `password`.

Registration process:

- Register with the [service](https://www1.aade.gr/webtax/wspublicreg/faces/pages/wspublicreg/menu.xhtml) using TAXISnet credentials.
- Obtain special access credentials through the [Special Credentials Management](https://www1.aade.gr/sgsisapps/tokenservices/protected/displayConsole.htm) application.

For more details and registration, visit the [Official AADE Page](https://www.aade.gr/anazitisi-basikon-stoiheion-mitrooy-epiheiriseon).

After registration, you will have the `username` and `password` needed to use the service.

```
use Firebed\VatRegistry\TaxisNet;
use Firebed\VatRegistry\VatException;

$username = 'your-username';
$password = 'your-password';

$taxis = new TaxisNet($username, $password);

try {
    $entity = $taxis->handle('094014201');

    print_r($entity);
} catch (VatException $exception) {
    echo "Σφάλμα: " . $exception->getMessage();
}
```

The result of the above call:

```
Firebed\VatRegistry\VatEntity {
  +vatNumber: "094014201"
  +taxAuthorityId: "1159"
  +taxAuthorityName: "ΦΑΕ ΑΘΗΝΩΝ"
  +flagDescription: "ΜΗ ΦΠ"
  +valid: true
  +validityDescription: "ΕΝΕΡΓΟΣ ΑΦΜ"
  +firmFlagDescription: "ΕΠΙΤΗΔΕΥΜΑΤΙΑΣ"
  +legalName: "ΤΡΑΠΕΖΑ ΕΘΝΙΚΗ ΤΗΣ ΕΛΛΑΔΟΣ ΑΝΩΝΥΜΗ ΕΤΑΙΡΕΙΑ"
  +commerceTitle: ""
  +legalStatusDescription: "ΑΕ"
  +street: "ΑΙΟΛΟΥ"
  +streetNumber: "86"
  +postcode: "10559"
  +city: "ΑΘΗΝΑ"
  +registrationDate: "1900-01-01"
  +stopDate: ""
  +normalVat: true
  +firms: array:2 [
    0 => array:4 [
      "code" => "64191204"
      "description" => "ΥΠΗΡΕΣΙΕΣ ΤΡΑΠΕΖΩΝ"
      "kind" => "1"
      "kindDescription" => "ΚΥΡΙΑ"
    ]
    1 => array:4 [
      "code" => "66221001"
      "description" => "ΥΠΗΡΕΣΙΕΣ ΑΣΦΑΛΙΣΤΙΚΟΥ ΠΡΑΚΤΟΡΑ ΚΑΙ ΑΣΦΑΛΙΣΤΙΚΟΥ ΣΥΜΒΟΥΛΟΥ"
      "kind" => "2"
      "kindDescription" => "ΔΕΥΤΕΡΕΥΟΥΣΑ"
    ]
  ]
}
```

### Check Natural Person / Company

[](#check-natural-person--company)

```
$entity->isNaturalPerson();
$entity->isCompany();
```

### Check Activity Status

[](#check-activity-status)

```
// Returns true if the business is active
// Returns false if the business has been discontinued
$entity->isActive();
```

If the VAT number is not valid, a `null` value is returned. If there was another issue, the `VatException` will contain the relevant error message.

Through the Business Registry Service (ΓΕ.ΜΗ.)
----------------------------------------------

[](#through-the-business-registry-service-γεμη)

This service allows searching all VAT numbers registered in the General Commercial Registry (ΓΕ.ΜΗ.). The Business Portal API requires an API key. You can request an API key by registering at  and following the instructions to obtain an API key for the Open Data API.

- Official Swagger documentation:
- Technical details about the API:

Before processing the request to the Business Portal API, this package will first check if the provided VAT number is valid, according to the Greek VAT number format. In case the VAT number is invalid, an `InvalidTinException` will be thrown.

```
use Firebed\VatRegistry\BusinessPortal\BusinessPortal;

$portal = new BusinessPortal('your-api-key');

// Search by company TIN
$response = $portal->searchCompany('094014201');

// Search by company registration number (ΓΕ.Ε.Μ.)
$response = $portal->showCompany('000237954001');

var_dump($response);
```

Through the VAT Information Exchange System (VIES) Service
----------------------------------------------------------

[](#through-the-vat-information-exchange-system-vies-service)

Using the VIES Service, you can verify the validity of a VAT number issued by any member state of the European Union. The details it provides are more limited compared to the AADE service.

The service is provided free of charge without registration with any entity. It accepts 2 parameters:

- The country code (e.g., EL for Greece)
- The VAT number you want to verify.

```
use Firebed\VatRegistry\VIES;
use Firebed\VatRegistry\VatException;

$taxis = new VIES();

try {
    $entity = $taxis->handle('EL', '094014201');

    print_r($entity);
} catch (VatException $exception) {
    echo "Σφάλμα: " . $exception->getMessage();
}
```

The result of the above call:

```
Firebed\VatRegistry\VatEntity {
  +vatNumber: "094014201"
  +taxAuthorityId: null
  +taxAuthorityName: null
  +flagDescription: null
  +valid: true
  +validityDescription: null
  +firmflagDescription: null
  +legalName: "ΤΡΑΠΕΖΑ ΕΘΝΙΚΗ ΤΗΣ ΕΛΛΑΔΟΣ ΑΝΩΝΥΜΗ ΕΤΑΙΡΕΙΑ"
  +commerceTitle: null
  +legalStatusDescription: null
  +street: "ΑΙΟΛΟΥ"
  +streetNumber: "86"
  +postcode: "10559"
  +city: "ΑΘΗΝΑ"
  +registrationDate: null
  +stopDate: null
  +normalVat: null
  +firms: []
}
```

If the VAT number is not valid, the service returns `null`.

###  Health Score

48

—

FairBetter than 95% of packages

Maintenance86

Actively maintained with recent releases

Popularity30

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 89.3% 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 ~58 days

Recently: every ~48 days

Total

12

Last Release

74d ago

Major Versions

v1.1.2 → v2.0.02025-11-25

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/37473473?v=4)[Okan Giritli](/maintainers/Firebed)[@firebed](https://github.com/firebed)

---

Top Contributors

[![firebed](https://avatars.githubusercontent.com/u/37473473?v=4)](https://github.com/firebed "firebed (25 commits)")[![isarantoglou](https://avatars.githubusercontent.com/u/98898337?v=4)](https://github.com/isarantoglou "isarantoglou (3 commits)")

---

Tags

business-registrysearch-greek-vatvat-searchviesafmΑναζήτηση ΑΦΜΜητώο ΑΦΜVAT SearchVAT RegistryBusiness RegistrySearch VAT

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/firebed-vat-registry/health.svg)

```
[![Health](https://phpackages.com/badges/firebed-vat-registry/health.svg)](https://phpackages.com/packages/firebed-vat-registry)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[facebook/php-business-sdk

PHP SDK for Facebook Business

90821.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

74513.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

265103.1M454](/packages/google-gax)[google/common-protos

Google API Common Protos for PHP

173103.7M50](/packages/google-common-protos)

PHPackages © 2026

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