To download company data and check the entity's VAT status and VIES system
For all interested people who want to test the operation of the provided libraries, plug-ins and add-ons for Microsoft Excel, a test API is available at: https://www.nip24.pl/api-test
Using the test API does not require creating an account on nip24.pl, and all functions of the test API work in exactly the same way as in the case of the production API (https://www.nip24.pl/api). The only limitation is the range of NIP, REGON, KRS and IBAN numbers for which inquiries can be sent.
Inquiries sent to api-test may concern only the following numbers assigned to specific functions:
| Function name | Description | Tax Identification Numbers | REGON numbers | KRS numbers | IBAN numbers |
| isActive | Function to check the current status of the company's activities | 7272445205 5213003700 5252242171 7171642051 |
472301670 010168068 017461044 141715362 |
0000030897 0000070444 |
n/a |
| getInvoiceData | Function for downloading basic company data enabling correct invoicing | 7272445205 5213003700 5252242171 7171642051 |
472301670 010168068 017461044 141715362 |
0000030897 0000070444 |
n/a |
| getAllData | Function for downloading detailed company data | 7272445205 5213003700 5252242171 7171642051 |
472301670 010168068 017461044 141715362 |
0000030897 0000070444 |
n/a |
| getVIESData | Function to confirm the activity of the EU VAT number assigned by any of the European Union Member States.
Attention! For EU VAT numbers from Germany (DE) and Spain (ES), the function returns only information about the validity of the EU VAT number, because in the production environment only such information is also returned. |
PL7272445205 PL5213003700 PL5252242171 PL7171642051 DE327990207 FR10402571889 DK56314210 ES38076731R PT501613897 CZ7710043187 IT06903461215 BG202211464 HU29312757 RO14388698 EL801116623 FI23064613 HR79147056526 LT100005828314 LV40203202898 SK2022210311 NL863726392B01 BE0835221567 ATU74581419 CY10137629O EE100110874 IE8251135U LU22108711 MT26572515 SE556037867001 SI51510847 |
n/a | n/a | n/a |
| getVATStatus | Function for checking the status of an entity in the VAT register available on the Tax Portal of the Ministry of Finance | 7272445205 5213003700 5252242171 7171642051 |
472301670 010168068 017461044 141715362 |
0000030897 0000070444 |
n/a |
| getIBANStatus | Function for verifying the contractor's bank account number in the list of VAT payers (so-called white list of VAT payers) | 7272445205 5213003700 5252242171 7171642051 |
472301670 010168068 017461044 141715362 |
n/a | PL17114000001527010928203867 PL19102000032736600040047813 PL63124000017766964359303930 PL49154000046458439719826658 |
| searchVATRegistry | Function for searching and downloading all contractor data from the list of VAT payers (so-called white list of VAT payers) | 7272445205 5213003700 5252242171 7171642051 |
472301670 010168068 017461044 141715362 |
0000030897 0000070444 |
PL17114000001527010928203867 PL19102000032736600040047813 PL63124000017766964359303930 PL49154000046458439719826658 |
Configuration
For production accounts, the key identifier and the key are generated by the user after logging in to their account on the nip24.pl portal. In the case of the test API, there is no need to create an account - just perform the configuration as described below.
In order to perform correct authentication, the test API requires that a parameterless constructor be used when constructing the client object. Here are examples for individual libraries:
- C#
- C/C++
- Java
- JavaScript
- PHP
- Python
- Visual Basic
- Excel
using nip24Library.dll;
// Utworzenie obiektu klienta usługi serwisu testowego
NIP24Client nip24 = new NIP24Client();#include "nip24.h"
// Utworzenie obiektu klienta usługi serwisu testowego
NIP24Client* nip24 = NULL;
nip24_new_test(&nip24);import pl.nip24.client.*;
// Utworzenie obiektu klienta usługi serwisu testowego
NIP24Client nip24 = new NIP24Client();var NIP24 = require('nip24client');
// Utworzenie obiektu klienta usługi serwisu testowego
var nip24 = new NIP24.NIP24Client();require_once 'NIP24/NIP24Client.php';
\NIP24\NIP24Client::registerAutoloader();
// Utworzenie obiektu klienta usługi serwisu testowego
$nip24 = new \NIP24\NIP24Client();from nip24 import *
from pprint import pprint
# Utworzenie obiektu klienta usługi serwisu testowego
nip24 = NIP24Client()' Utworzenie obiektu klienta usługi serwisu testowego
Dim nip24 As New NIP24Client# Utworzenie obiektu klienta usługi serwisu testowego
=NIP24.POŁĄCZ.TEST()Usage
Checking the individual functionalities of the test API involves calling the individual functions described in detail on the website documentation with the parameters (Tax Identification Number, REGON, KRS, IBAN) listed above.
Each of the libraries we provide contains the source code of an example program called example, which illustrates the correct use of all API functions.
English (UK) 
Polski