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

ActiveLibrary[API Development](/categories/api)

mariankustusch/regon-api
========================

GUS Regon API

2.0.1(8mo ago)01MITPHPPHP >=7.2

Since Aug 19Pushed 8mo agoCompare

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

READMEChangelog (1)Dependencies (15)Versions (2)Used By (0)

[![Latest Stable Version](https://camo.githubusercontent.com/f5d5e637a578f023dab9575ae83f688d7acc1cd54fbdce6de346b06063008367/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6d72636e70646c6b2f7265676f6e2d6170692e737667)](https://packagist.org/packages/mrcnpdlk/regon-api)[![Latest Unstable Version](https://camo.githubusercontent.com/95257696b6229a05abad450c340edb0999a1b39381cacaa832b8e09f04fc43a4/68747470733a2f2f706f7365722e707567782e6f72672f6d72636e70646c6b2f7265676f6e2d6170692f762f756e737461626c652e706e67)](https://packagist.org/packages/mrcnpdlk/regon-api)[![Total Downloads](https://camo.githubusercontent.com/fa8809247ecb5a372457bf4fc020c0a7e6fb9d8548b5a55bcea5d677a9fe708e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d72636e70646c6b2f7265676f6e2d6170692e737667)](https://packagist.org/packages/mrcnpdlk/regon-api)[![Monthly Downloads](https://camo.githubusercontent.com/0e8b92cdab92098ef6ec9d19e962c1fd6d59847a4e0481f2c20579e707fbaf39/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f6d72636e70646c6b2f7265676f6e2d6170692e737667)](https://packagist.org/packages/mrcnpdlk/regon-api)[![License](https://camo.githubusercontent.com/9c2d6a89c36eaab8e07af3df6caae166e49b86a2f7b65fb7b271a5cd68245160/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6d72636e70646c6b2f7265676f6e2d6170692e737667)](https://packagist.org/packages/mrcnpdlk/regon-api)

REGON API - Polish companies database v2
========================================

[](#regon-api---polish-companies-database-v2)

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

[](#installation)

Install the latest version with [composer](https://packagist.org/packages/mrcnpdlk/regon-api)

```
composer require mariankustusch/regon-api
```

API uses [BIR 1.1](https://api.stat.gov.pl/Home/RegonApi)

Basic usage
-----------

[](#basic-usage)

### Configuration

[](#configuration)

Available options:

Parameter nameDescriptionIs requiredpasswordPassword to REGON apiYESwsdlpath to WSDLNOlocationpath do SVC locationNOcacheDirpath do cache directoryNO (system dir cache)cacheTtlcache ttl \[sec\]NO (60 sec)### Creating instance

[](#creating-instance)

```
$oConfig = new Mrcnpdlk\Api\Regon\Config([
    'password' => 'my_password',
]);

$oNativeApi = new \Mrcnpdlk\Api\Regon\NativeApi($oConfig);
$oApi = new \Mrcnpdlk\Api\Regon\Api($oConfig);
```

NativeApi
---------

[](#nativeapi)

`NativeApi` class implements native GUS methods such like:

- Zaloguj()
- Wyloguj()
- GetValue(ValueEnum $param)
- DaneSzukajPodmioty( string $regon = null, string $nip = null, string $krs = null, array $tRegon = \[\], array $tNip = \[\], array $tKrs = \[\])
- DanePobierzRaportZbiorczy(string $date, ReportCompactEnum $report)
- DanePobierzPelnyRaport(string $regon, ReportFullEnum $report)

Api
---

[](#api)

`Api` class implements usable methods based on `NativeApi` class.

- searchByNip()
- searchByKrs()
- searchByRegon()
- getPKD()
- getReport()

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance62

Regular maintenance activity

Popularity1

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity30

Early-stage or recently created project

 Bus Factor1

Top contributor holds 93.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

Unknown

Total

1

Last Release

263d ago

### Community

Maintainers

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

---

Top Contributors

[![mrcnpdlk](https://avatars.githubusercontent.com/u/22945316?v=4)](https://github.com/mrcnpdlk "mrcnpdlk (43 commits)")[![mariankustusch](https://avatars.githubusercontent.com/u/30049465?v=4)](https://github.com/mariankustusch "mariankustusch (3 commits)")

---

Tags

soapregonnipGUSkrs

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[gusapi/gusapi

Gus Api Library for PHP

1351.5M8](/packages/gusapi-gusapi)[algolia/algoliasearch-client-php

API powering the features of Algolia.

69333.0M113](/packages/algolia-algoliasearch-client-php)[phpforce/soap-client

A PHP client for the Salesforce SOAP API

831.9M1](/packages/phpforce-soap-client)[freshcells/soap-client-bundle

SoapClientBundle for symfony

35151.0k](/packages/freshcells-soap-client-bundle)[commercetools/commercetools-sdk

The official PHP SDK for the commercetools Composable Commerce APIs

19281.5k](/packages/commercetools-commercetools-sdk)[mrcnpdlk/teryt-api

Teryt WS1 Api

1640.6k1](/packages/mrcnpdlk-teryt-api)

PHPackages © 2026

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