composer require omisai/php-creditonline

use Omisai\CreditOnline\Configuration;

$config = new Configuration();

// Use the test environment
$config->setTestHost();
// or
$config->setHost('https://api-test.creditonline.hu/v3');


// Enable debug mode (logs to stdout)
$config->setDebug(true);

// Set a custom user agent
$config->setUserAgent('MyApp/1.0');

// mTLS authentication
$config->setCertFile('/path/to/cert.pem');
$config->setKeyFile('/path/to/key.pem');

$api = new GetDataByIdService(config: $config, hostIndex: 1);

$api->setHostIndex(1);

$client = new \GuzzleHttp\Client(['timeout' => 30]);
$api = new AuthenticationService(client: $client);

use Omisai\CreditOnline\Api\AuthenticationService;

$api = new AuthenticationService();

// Simple call (returns void — token is set server-side)
$api->getToken('your-api-key');

// To retrieve the token, use the WithHttpInfo variant:
list($body, $statusCode, $headers) = $api->getTokenWithHttpInfo('your-api-key');

// Optionally specify format and language:
// $api->getToken('your-api-key', 'json', 'hu');

use Omisai\CreditOnline\Api\GetDataByIdService;
use Omisai\CreditOnline\Model\ApiResult;

$api = new GetDataByIdService();

// By registration number
$result = $api->getData($token, regnumber: '01-09-562111');

// By tax number (use "EV_" prefix for sole proprietors)
$result = $api->getData($token, taxnumber: '12345678-2-41');

// $result is an ApiResult object
var_dump($result->getLimitReached()); // bool
foreach ($result->getCompanies() as $company) {
    echo $company->getName();
    echo $company->getTaxnumber();
    echo $company->getRating();
}

use Omisai\CreditOnline\Api\GetDailyMonitoringService;

$api = new GetDailyMonitoringService();

$events = $api->getDailyMonitoring($token, new \DateTime('2025-01-15'));

foreach ($events as $event) {
    echo $event->getName();       // Company name
    echo $event->getTaxnumber();  // Tax number
    echo $event->getCategory();   // Event category
    echo $event->getLink();       // Detail link
}

use Omisai\CreditOnline\Api\GetProfileAndTrafficDataService;

$api = new GetProfileAndTrafficDataService();

$profile = $api->getProfile($token);

echo $profile->getCompanyName();
echo $profile->getActualFormat();
echo $profile->getActualLanguage();

foreach ($profile->getActualUsages() as $usage) {
    echo $usage->getType();   // Usage type
    echo $usage->getLimit();  // Limit
    echo $usage->getIds();    // IDs
}

use Omisai\CreditOnline\ApiException;

try {
    $result = $api->getData($token, regnumber: '01-09-562111');
} catch (ApiException $e) {
    echo 'HTTP Status: ' . $e->getCode();
    echo 'Message: ' . $e->getMessage();
    // $e->getResponseHeaders() returns response headers (nullable)
    // $e->getResponseBody() returns response body as string (nullable)
}

$promise = $api->getDataAsync($token, regnumber: '01-09-562111');
$promise->then(function (ApiResult $result) {
    foreach ($result->getCompanies() as $company) {
        echo $company->getName();
    }
});

[$result, $statusCode, $headers] = $api->getDataWithHttpInfo($token, regnumber: '01-09-562111');

$promise = $api->getDataAsyncWithHttpInfo($token, regnumber: '01-09-562111');

<?php

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

use Omisai\CreditOnline\Api\AuthenticationService;
use Omisai\CreditOnline\Api\GetDataByIdService;
use Omisai\CreditOnline\Api\GetDailyMonitoringService;
use Omisai\CreditOnline\Api\GetProfileAndTrafficDataService;
use Omisai\CreditOnline\Configuration;

$apiKey = 'your-api-key';

// Use test environment
$config = new Configuration();
$config->setHost('https://api-test.creditonline.hu/v3');

// 1. Generate token
$tokenApi = new AuthenticationService($config);
list(, , $headers) = $tokenApi->getTokenWithHttpInfo($apiKey);
$token = $headers['Token'][0] ?? null; // Token returned in response headers

// 2. Look up a company by registration number
$dataApi = new GetDataByIdService($config);
$result = $dataApi->getData($token, regnumber: '01-09-562111');

echo 'Limit reached: ' . ($result->getLimitReached() ? 'Yes' : 'No') . "\n\n";

foreach ($result->getCompanies() as $company) {
    echo 'Company: ' . $company->getName() . "\n";
    echo 'Tax number: ' . $company->getTaxnumber() . "\n";
    echo 'Rating: ' . $company->getRating() . "\n";
    echo 'Credit limit: ' . $company->getCreditLimit() . "\n\n";
}

// 3. Fetch daily monitoring events
$monitoringApi = new GetDailyMonitoringService($config);
$events = $monitoringApi->getDailyMonitoring($token, new \DateTime('yesterday'));

foreach ($events as $event) {
    echo $event->getName() . ' — ' . $event->getCategory() . "\n";
}

// 4. Check profile usage
$profileApi = new GetProfileAndTrafficDataService($config);
$profile = $profileApi->getProfile($token);

echo 'Profile: ' . $profile->getCompanyName() . "\n";
foreach ($profile->getActualUsages() as $usage) {
    echo '  ' . $usage->getType() . ': ' . $usage->getIds() . ' / ' . $usage->getLimit() . "\n";
}

composer test