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

ActiveLibrary[API Development](/categories/api)

vat-api/vat-api
===============

Polish VAT API Library for PHP

2.0.0(2y ago)7504↓50%3LGPL-2.1-or-laterPHPPHP ^7.1|^8.0

Since Oct 19Pushed 2y ago1 watchersCompare

[ Source](https://github.com/johnzuk/VatApi)[ Packagist](https://packagist.org/packages/vat-api/vat-api)[ RSS](/packages/vat-api-vat-api/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (4)Versions (3)Used By (0)

PHP VAT API library
===================

[](#php-vat-api-library)

[![Packagist](https://camo.githubusercontent.com/f4ae6da968bc8e463d41a164e8e7a5f162a8915de2a249a3cff852461ba73a3e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f7661742d6170692f7661742d6170692e737667)](https://packagist.org/packages/vat-api/vat-api)[![Build Status](https://camo.githubusercontent.com/5b701e381fc2cd4609bb7cb3bdf893b14ed78dbbfb15f32285ae469b91278bdf/68747470733a2f2f7472617669732d63692e6f72672f6a6f686e7a756b2f5661744170692e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/johnzuk/VatApi)[![Codecov](https://camo.githubusercontent.com/a5451f147ad6c01e78b42725e854f39e9e3afe37d2c469af7ce1ee8ea0d82d3b/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f6769746875622f6a6f686e7a756b2f5661744170692f6d61737465722e737667)](https://codecov.io/gh/johnzuk/VatApi)[![Packagist](https://camo.githubusercontent.com/eee98426261b8fd1b75997afa157d1a42cc697515aeb53a5febb606190652564/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7661742d6170692f7661742d6170692e737667)](https://packagist.org/packages/vat-api/vat-api)[![Packagist](https://camo.githubusercontent.com/19a74e06e55234b31bb0181066a5bc25acadab6d741ce3c464ea37334453c0a0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7661742d6170692f7661742d6170692e737667)](https://packagist.org/packages/vat-api/vat-api)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/bb94dca543a1be009ddf9c48a6184a467f3842ec2b601d08596380336d5b3506/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6a6f686e7a756b2f5661744170692f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/johnzuk/VatApi/?branch=master)

PHP VAT API is an object-oriented library to get information from [mf.gov.pl](https://sprawdz-status-vat.mf.gov.pl/) based on **official** Ministerstwo Finansów SOAP API. Official docs [here](https://www.finanse.mf.gov.pl/c/document_library/get_file?uuid=fba25e1b-68dc-4f59-8193-323046002134&groupId=766655).

Example
=======

[](#example)

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

$api = new VatApi\VatApi();
$nip = 'xxxxxxxxxx';

try {
    $status = $api->getNipStatus($nip);

    if ($status === \VatApi\TaxStatusInterface::TAXPAYER_ACTIVE) {
        echo 'Podmiot o podanym identyfikatorze podatkowy NIP jest zarejestrowany jako podatnik VAT czynny';
    } else if ($status === \VatApi\TaxStatusInterface::TAXPAYER_NOT_ACTIVE) {
        echo 'Podmiot o podanym identyfikatorze podatkowym NIP nie jest zarejestrowany jako podatnik VAT';
    } else if ($status === \VatApi\TaxStatusInterface::TAXPAYER_FREE) {
        echo 'Podmiot o podanym identyfikatorze podatkowym NIP jest zarejestrowany jako podatnik VAT zwolniony';
    }
} catch (\VatApi\Exception\InvalidNipNumberException $e) {
    echo $e->getMessage();
} catch (\VatApi\Exception\InvalidCodeValueException $e) {
    echo 'Błąd odpowiedzi serwera';
}
```

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 50% 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 ~1825 days

Total

2

Last Release

942d ago

Major Versions

1.0.0 → 2.0.02023-10-19

PHP version history (2 changes)1.0.0PHP ^7.1

2.0.0PHP ^7.1|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/d096633bd6d714c4ce9e3b3d04da07681692d1b5050ed255051036dff3abecd8?d=identicon)[johnzuk](/maintainers/johnzuk)

---

Top Contributors

[![johnzuk](https://avatars.githubusercontent.com/u/5394761?v=4)](https://github.com/johnzuk "johnzuk (2 commits)")[![michael-rubel](https://avatars.githubusercontent.com/u/37669560?v=4)](https://github.com/michael-rubel "michael-rubel (1 commits)")[![zembrowski](https://avatars.githubusercontent.com/u/2451083?v=4)](https://github.com/zembrowski "zembrowski (1 commits)")

---

Tags

apilibrarysoapvattaxnipmfe-podatki

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[gusapi/gusapi

Gus Api Library for PHP

1351.5M8](/packages/gusapi-gusapi)[taxamo/taxamo-php

Taxamo PHP Library

11119.2k](/packages/taxamo-taxamo-php)

PHPackages © 2026

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