gusapi/gusapi

Gus Api Library for PHP

6.3.2 2025-10-07 12:21 UTC

Requires

• php: ^8.1
• ext-json: *
• ext-simplexml: *
• ext-soap: *

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.11
• phpstan/phpstan: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• phpunit/phpunit: ^10.0
• squizlabs/php_codesniffer: ^3.7 || ^4.0

LGPL-2.1-or-later

• Janusz Żukowicz

• api
• library
• soap
• regon
• nip
• GUS
• CEIDG
• krs

Published on Packagist.org on 2025-10-07 12:23 UTC

README

PHP GUS API is an object-oriented library to get information from REGON site based on official REGON SOAP API. Official GUS docs here.

Installation

This library uses Composer, just type in:

composer require gusapi/gusapi

Supported Versions

Version	PHP version	BIR service version	Support	Doc
6.x	>= 8.0	BIR1.1 (available since October 2022)	Support ends on April 1, 2023	Doc
5.x	>= 7.1	BIR1.1 (available since May 2019)	Support ends on December 1, 2020	Doc

If you still use PHP <= 8.0 see documentation for 5.x version HERE

Upgrade from 5.x to 6.x

For more information see UPGRADE.md.

Example for 6.x

See file examples/readmeExample.php.

require_once '../vendor/autoload.php';

use GusApi\Exception\InvalidUserKeyException;
use GusApi\Exception\NotFoundException;
use GusApi\GusApi;
use GusApi\ReportTypes;
use GusApi\BulkReportTypes;

$gus = new GusApi('your api key here');
//for development server use:
//$gus = new GusApi('abcde12345abcde12345', 'dev');

try {
    $nipToCheck = 'xxxxxxxxxx'; //change to valid nip value
    $gus->login();

    $gusReports = $gus->getByNip($nipToCheck);

    var_dump($gus->dataStatus());
    var_dump($gus->getBulkReport(
        new DateTimeImmutable('2019-05-31'),
        BulkReportTypes::REPORT_DELETED_LOCAL_UNITS
    ));

    foreach ($gusReports as $gusReport) {
        //you can change report type to other one
        $reportType = ReportTypes::REPORT_PERSON;
        echo $gusReport->getName();
        echo 'Address: ' . $gusReport->getStreet() . ' ' . $gusReport->getPropertyNumber() . '/' . $gusReport->getApartmentNumber();

        $fullReport = $gus->getFullReport($gusReport, $reportType);
        var_dump($fullReport);
    }
} catch (InvalidUserKeyException $e) {
    echo 'Bad user key';
} catch (NotFoundException $e) {
    echo 'No data found <br>';
    echo 'For more information read server message below: <br>';
    echo sprintf(
        "StatusSesji:%s\nKomunikatKod:%s\nKomunikatTresc:%s\n",
        $gus->getSessionStatus(),
        $gus->getMessageCode(),
        $gus->getMessage()
    );
}

Stargazers over time