be-soft/finstat

FinStat.sk API client for PHP

v1.0.0 2026-08-05 11:07 UTC

Requires

• php: ^7.1 || ^8.0
• ext-json: *
• ext-mbstring: *
• consistence-community/consistence: ~1.0 || ~2.0
• nette/utils: ^2.2 || ^3.0 || ^4.0

Suggests

• guzzlehttp/guzzle: If you don't want to implement your own API request client (IRequestClient), the Guzzle HTTP client is required.

MIT

• BE-SOFT a.s.
• Petr Hubík

• api
• finstat
• finstat api

Published on Packagist.org on 2026-08-05 11:14 UTC

README

Note This project is a fork of hubipe/finstat, created to fix issues with case-sensitive HTTP header handling.

FinStat.sk API client

This is an API client for finstat.sk, Slovakian company register.

How to install

Install package hubipe/finstat with Composer:

composer require be-soft/finstat

So far, in the library, there is only one implemented RequestClient - GuzzleRequestClient. If you don't want to implement your own, you'll also need to require

composer require guzzlehttp/guzzle

How to use

Using client is easy - all you have to do is initiate FinStat class by passing it request client, API key and private API key:

<?php
use Hubipe\FinStat\FinStat;
use Hubipe\FinStat\Request\GuzzleRequestClient;

$requestClient = new GuzzleRequestClient();
$client = new FinStat(
	$requestClient,
	$apiKey,
	$privateKey
);

When client is instantiated, you can start querying API:

$detailResult = $client->detail('36631124');
$autocompleteResult = $client->autocomplete('Slovenská pošta');
$czAutocompleteResult = $client->czAutocomplete('Česká pošta');

Implemented API methods

This client has implemented so far these API methods:

• autocomplete
• detail
• CZ autocomplete
• CZ detail

If you wish to implement other methods, please send a pull request.