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(4mo ago)221.6k↑21.4%5MITPHPPHP ^8.0

Since Jun 2Pushed 4mo 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 2d 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

47

—

FairBetter than 93% of packages

Maintenance78

Regular maintenance activity

Popularity31

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity53

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

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

[exsyst/swagger

A php library to manipulate Swagger specifications

35916.4M7](/packages/exsyst-swagger)[hubspot/api-client

Hubspot API client

24016.2M20](/packages/hubspot-api-client)[pocketmine/bedrock-protocol

An implementation of the Minecraft: Bedrock Edition protocol in PHP

172445.0k15](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram

Telegram driver for BotMan

93459.5k6](/packages/botman-driver-telegram)

PHPackages © 2026

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