PHPackages                             h4kuna/ares - 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. [Utility & Helpers](/categories/utility)
4. /
5. h4kuna/ares

ActiveLibrary[Utility & Helpers](/categories/utility)

h4kuna/ares
===========

Provides information about subjects by their identification number from the ARES database (in Czech Republic).

v3.0.14(5mo ago)50394.6k—7.4%182MITPHPPHP >=8.0CI passing

Since Dec 9Pushed 2mo ago6 watchersCompare

[ Source](https://github.com/h4kuna/ares)[ Packagist](https://packagist.org/packages/h4kuna/ares)[ Docs](https://github.com/h4kuna/ares)[ Fund](https://revolut.me/milan2m/czk1000/ares)[ GitHub Sponsors](https://github.com/h4kuna)[ RSS](/packages/h4kuna-ares/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (8)Dependencies (8)Versions (55)Used By (2)

[![Downloads this Month](https://camo.githubusercontent.com/bbf74c7c81157e4cf1e7baf569686107720d11dc3c4edf1610419ad31dc1bcfd/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f68346b756e612f617265732e737667)](https://packagist.org/packages/h4kuna/ares)[![Latest Stable Version](https://camo.githubusercontent.com/24d3fbe2bf085f4038f25ee56db5b56807c7c279e42b31fb137701ce92be12e0/68747470733a2f2f706f7365722e707567782e6f72672f68346b756e612f617265732f762f737461626c653f666f726d61743d666c6174)](https://packagist.org/packages/h4kuna/ares)[![Coverage Status](https://camo.githubusercontent.com/812cfe9e14f1fbb29cdfb37b5354ba164ae7518edf1eb8056fa2abbd67f506c7/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f68346b756e612f617265732f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/h4kuna/ares?branch=master)[![Total Downloads](https://camo.githubusercontent.com/ad229cc2154639f8cc0559e40be99e01545cb39a952945c94aed4e5fff78da85/68747470733a2f2f706f7365722e707567782e6f72672f68346b756e612f617265732f646f776e6c6f6164733f666f726d61743d666c6174)](https://packagist.org/packages/h4kuna/ares)[![License](https://camo.githubusercontent.com/a1f0f3fe8ad42568b0b65b7275a7bf13bf16d4314ce771d917af4f025967f230/68747470733a2f2f706f7365722e707567782e6f72672f68346b756e612f617265732f6c6963656e73653f666f726d61743d666c6174)](https://packagist.org/packages/h4kuna/ares)

More information about versions is in [changelog](changelog.md).

Support development by QR code
------------------------------

[](#support-development-by-qr-code)

Use QR code or sponsor button where is link on my revolut.

Thank you :)

[![QR payment](./.doc/payment.png)](./.doc/payment.png)

Installation to project
-----------------------

[](#installation-to-project)

The best way to install h4kuna/ares is using Composer:

```
composer require h4kuna/ares

# optional and default support
composer require guzzlehttp/guzzle
```

Download information about customer via his IN.

ARES
----

[](#ares)

[Homepage](https://ares.gov.cz/stranky/vyvojar-info) documentation for developers.

Load data by one identification number.

```
use h4kuna\Ares;
$ares = (new Ares\AresFactory())->create();
try {
    $response = $ares->loadBasic('87744473');
    /* @var $response Ares\Ares\Core\Data */
    var_dump($response);
} catch (Ares\Exception\IdentificationNumberNotFoundException $e) {
    // log identification number, why is bad? Or make nothing.
} catch (Ares\Exception\AdisResponseException $e) {
    // if validation by adis failed, but data from ares returned
    /* @var $response Ares\Ares\Core\Data */
    $response = $e->data;
    $response->adis === null; // true
    var_dump($e->getMessage());
} catch (Ares\Exception\ServerResponseException $e) {
    // no response from server or broken json
}
```

Load data by many identification numbers. Limit by ARES service is set to 100 items, but library chunk it and check duplicity.

```
use h4kuna\Ares;
/** @var Ares\Ares $ares */
$numbers = ['one' => '25596641', 'two' => '26713250', 'three' => '27082440', 'four' => '11111111'];

try {
    foreach ($ares->loadBasicMulti($numbers) as $name => $r) {
        var_dump($name, $r->company);
    }
} catch (Ares\Exception\ServerResponseException $e) {
    // no response from server or broken json
}
```

### Other endpoints

[](#other-endpoints)

Choose endpoint from class [Sources](./src/Ares/Sources.php).

- SERVICE\_\* - available other endpoints
- CORE - is main endpoint this is used in method `$ares->loadBasic()`
- DIAL - use if you want list of value for example `PravniForma`
- SER\_NO\_\* are not exists

```
use h4kuna\Ares;

/** @var Ares\Ares $ares */
$result = $ares->getAresClient()->useEndpoint(Ares\Ares\Sources::SERVICE_VR, '27082440');
var_dump($result);
```

#### Dials

[](#dials)

Parameters `kodCiselniku` and `zdrojCiselniku` you can find in json file, on this page [AresRestApi-verejne\_v\*.json](https://ares.gov.cz/stranky/vyvojar-info), like a `ciselnikKod: PravniForma, zdroj: res`.

```
use h4kuna\Ares;

/** @var Ares\Ares $ares */
$result = $ares->getAresClient()->searchEndpoint(Ares\Ares\Sources::DIAL, [
	'kodCiselniku' => 'PravniForma',
	'zdrojCiselniku' => 'res',
])->ciselniky[0]->polozkyCiselniku;

foreach ($result as $item) {
	var_dump($item);
}
```

Data Box (datová schánka)
-------------------------

[](#data-box-datová-schánka)

[Manual](https://www.mojedatovaschranka.cz/sds/p/download/sds_webove_sluzby.pdf#view=Fit)

```
use h4kuna\Ares;
/** @var Ares\Ares $ares */
try {
    $response = $ares->loadDataBox('87744473');
    var_dump($response->ISDS);
} catch (h4kuna\Ares\Exception\ServerResponseException $e) {
    // catch error
}
```

VIES
----

[](#vies)

Support [base check](https://ec.europa.eu/taxation_customs/vies/).

```
use h4kuna\Ares;
/** @var Ares\Ares $ares */

try {
    $response = $ares->checkVatVies($vatNumber);
    var_dump($response->valid); // true / false
} catch (Ares\Exception\ServerResponseException $e) {
    // invalid VAT
}
```

###  Health Score

62

—

FairBetter than 99% of packages

Maintenance78

Regular maintenance activity

Popularity49

Moderate usage in the ecosystem

Community22

Small or concentrated contributor base

Maturity82

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 96.5% 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 ~96 days

Total

50

Last Release

165d ago

Major Versions

v1.4.14 → v2.0.02022-12-17

v2.0.5 → v3.0.02023-09-28

PHP version history (4 changes)v1.0.0PHP >=5.3.2

v1.4.0PHP >=7.1

v2.0.0PHP >=7.4

v2.0.3PHP >=8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/54b4efb9b89167fa3598b1a41477b20387390f4a0fb65b447bd6bb7c30a49020?d=identicon)[h4kuna](/maintainers/h4kuna)

---

Top Contributors

[![h4kuna](https://avatars.githubusercontent.com/u/335722?v=4)](https://github.com/h4kuna "h4kuna (195 commits)")[![radimvaculik](https://avatars.githubusercontent.com/u/461164?v=4)](https://github.com/radimvaculik "radimvaculik (4 commits)")[![BigOHenry](https://avatars.githubusercontent.com/u/15823552?v=4)](https://github.com/BigOHenry "BigOHenry (2 commits)")[![Domm98CZ](https://avatars.githubusercontent.com/u/7610662?v=4)](https://github.com/Domm98CZ "Domm98CZ (1 commits)")

---

Tags

aresphp

###  Code Quality

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/h4kuna-ares/health.svg)

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

###  Alternatives

[embed/embed

PHP library to retrieve page info using oembed, opengraph, etc

2.1k11.0M97](/packages/embed-embed)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)[shopware/app-php-sdk

Shopware App SDK for PHP

1577.8k1](/packages/shopware-app-php-sdk)[phpro/http-tools

HTTP tools for developing more consistent HTTP implementations.

28137.8k](/packages/phpro-http-tools)

PHPackages © 2026

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