PHPackages                             asisteam/mvcr-document-validator - 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. asisteam/mvcr-document-validator

ActiveLibrary[API Development](/categories/api)

asisteam/mvcr-document-validator
================================

Implemenation of communication with MVCR document validator API

v1.2(6y ago)11.3kMITPHPPHP >= 7.1

Since Dec 21Pushed 6y ago2 watchersCompare

[ Source](https://github.com/AsisTeam/mvcr-document-validator)[ Packagist](https://packagist.org/packages/asisteam/mvcr-document-validator)[ Docs](https://github.com/AsisTeam/mvcr-document-validator)[ RSS](/packages/asisteam-mvcr-document-validator/feed)WikiDiscussions master Synced 2mo ago

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

AsisTeam > MVCR document validator
=====================================

[](#asisteam--mvcr-document-validator)

[![Build Status](https://camo.githubusercontent.com/519318964219fbdd3d77b6b35c62500e8b2f4022cc7322db9d4ac3d74763edbc/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f636f6d2f417369735465616d2f6d7663722d646f63756d656e742d76616c696461746f722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.com/AsisTeam/mvcr-document-validator)[![Licence](https://camo.githubusercontent.com/c5d10880cc909078bb54d184c6e0d300dc961012523d4b15c532af4d7a4edf1e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f417369735465616d2f6d7663722d646f63756d656e742d76616c696461746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/AsisTeam/mvcr-document-validator)[![Downloads this Month](https://camo.githubusercontent.com/198f92d68c8ef0674d52db86afa60024038e23e83430b14773a83d86e841cea8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f417369735465616d2f6d7663722d646f63756d656e742d76616c696461746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/AsisTeam/mvcr-document-validator)[![Downloads total](https://camo.githubusercontent.com/ccaff7368904a19301438f818db80e0751eb1580c11fade8a45ae72dceb5c97f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f417369735465616d2f6d7663722d646f63756d656e742d76616c696461746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/AsisTeam/mvcr-document-validator)[![Latest stable](https://camo.githubusercontent.com/cce3a51f8947af9ee9d51c69ee6f70196a7bf9cd16f44259c4b37d7c0d35da87/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f417369735465616d2f6d7663722d646f63756d656e742d76616c696461746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/AsisTeam/mvcr-document-validator)[![PHPStan](https://camo.githubusercontent.com/441b5874ce4df0a2defc892979c96c46889b69cb32119d04f0b48626349f8bc9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d656e61626c65642d627269676874677265656e2e7376673f7374796c653d666c6174)](https://github.com/phpstan/phpstan)

Credits
-------

[](#credits)

The development is under [AsisTeam s.r.o.](https://www.asisteam.cz/). Feel free to use and contribute.

[![Asisteam](https://camo.githubusercontent.com/bcbfc5aa03aa7bd291a47aba5b50b31ed2a910a2c95d5dd81ff08d57fc97c417/68747470733a2f2f7777772e617369737465616d2e637a2f696d672f6c6f676f2e737667 "Asisteam")](https://camo.githubusercontent.com/bcbfc5aa03aa7bd291a47aba5b50b31ed2a910a2c95d5dd81ff08d57fc97c417/68747470733a2f2f7777772e617369737465616d2e637a2f696d672f6c6f676f2e737667)

Install
-------

[](#install)

```
composer require asisteam/mvcr-document-validator

```

Versions
--------

[](#versions)

StateVersionBranchPHPdevelopment`^0.1``master``>= 7.1`production`^1.0``master``>= 7.1`Overview
--------

[](#overview)

This package communicates with MVČR API and check if given document is found amomg registered invalid documents. Create `Validator` client instance and call it's `validate` method passing the given `Document` entity.

Following document types can be validated:

- Czech personal id cards
- Czech passports (issued centrally or regionally)
- Czech gun licenses

Original MVČR documentation to be found at:

Usage
-----

[](#usage)

Juc create `Document` object and `Validator` instance and pass the `Document` to `Validator's` method `validate`, which returns `ValidatorResult` object. Using `ValidatorResult` you can verify whether the given document is marked as invalid in MVČR registries or not. Furthermore you may get the information when the document was added to the registries and when the registries themselves were last updated.

Please use `DocumentType` enum for specifying the document type.

```
$document = new Document('123456AB', DocumentType::PERSONAL_ID_CARD);
$response = (new Validator())->validate($document);

// true if given document was found in registry of invalid documents
$response->isInvalid();
```

Or you can configure it as Nette Framework DI service

```
extensions:
	mvcr.doc_validator: AsisTeam\MVCR\DocumentValidator\Bridges\Nette\DI\ValidatorExtension

mvcr.doc_validator:
	timeout: 5
```

If any problem during doing the Request to API or parsing the response the `ResponseException` in being thrown.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 80% 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 ~251 days

Total

3

Last Release

2194d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/045423c294f704cbab5e17d28681e83ac6b920a05498424fc64359c3d0cd1928?d=identicon)[holantomas](/maintainers/holantomas)

---

Top Contributors

[![kedlas](https://avatars.githubusercontent.com/u/3510893?v=4)](https://github.com/kedlas "kedlas (4 commits)")[![holantomas](https://avatars.githubusercontent.com/u/5030499?v=4)](https://github.com/holantomas "holantomas (1 commits)")

---

Tags

apipassportmvcrpersonal id cardgun license

### Embed Badge

![Health badge](/badges/asisteam-mvcr-document-validator/health.svg)

```
[![Health](https://phpackages.com/badges/asisteam-mvcr-document-validator/health.svg)](https://phpackages.com/packages/asisteam-mvcr-document-validator)
```

###  Alternatives

[apigen/apigen

PHP source code API generator.

2.2k627.9k223](/packages/apigen-apigen)

PHPackages © 2026

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