Transparent Data API
Niniejsza dokumentacja techniczna została wystawiona przez firmę Transparent Data dla jej Klientów i opisuje metody oraz sposoby korzystania z API, zwracającego dane z polskich rejestrów handlowych i baz własnych. Dane z KRS, CEIDG, Białej Listy, sprawozdań finansowych, raportów i wielu innych źródeł zostały szczegółowo opisane w sekcji Dostępne źródła danych.
API udostępnia dwa główne endpointy, które sprawiają, że cała usługa działa w sposób asynchroniczny, tak aby istniała możliwość integrowania wielu źródeł niezależnie - jeden służy do składania zleceń integrowania danych, drugi natomiast do sprawdzania statusu i pobierania wyników działania API.
Poza tym, API udostępnia również endpointy, pozwalające na zarządzanie monitoringiem firm oraz ksiąg wieczystych.
Przykładowa kolekcja
Dostępna jest przykładowa kolekcja dla aplikacji Postman. W celu uruchomienia należy pobrać plik następnie zaimportować go.
Aby móc korzystać należy uzypełnić zmienne.
Prawym przyciskiem myszki klikamy na folder i przechodzimy do edycji. Następnie przechodzimy do zakładki Variables
| Nazwa | Opis |
|---|---|
key |
Klucz otrzymany przy zakładaniu usługi - wymagane |
username |
Nazwa użytkownika otrzymana przy zakładaniu usługi - wymagane |
password |
Hasło użytkownika otrzymane przy zakładaniu usługi - wymagane |
email |
Email - opcjonalne* |
nip_krs |
Numer nip KRS - opcjonalne* |
nip_ceidg |
Numer nip CEIDG - opcjonalne* |
pesel |
Numer PESEL (np źródło BIG KRD) - opcjonalne* |
person |
Imię i nazwisko (np źródło - PEP) - opcjonalne* |
nip_regon |
Numer nip REGON - opcjonalne* |
bank_account |
Numer konta bankowego - opcjonalne* |
kw_number |
Numer księgi wieczystej - opcjonalne* |
* w zależności od źródła danych
Endpoint /add
Przykładowy JSON który należy wysłać do API
{
"source": "ZRODLO_DANYCH",
"method": "NAZWA_METODY",
"params": {
"PARAMETR": 1
}
}
Przykładowe wywołanie:
curl --user:pass -d '{"source":"ZRODLO_DANYCH", "method":"NAZWA_METODY", "params" :{"PARAMETR":1} }' https://api.transparentdata.pl/key/add
Przykładowa odpowiedź:
{
"status": "quened",
"ident": "a4a69bb9-8619-4927-89c5-e03e30f69897"
}
Całe wywołanie API sprowadza się do wysłania zapytania w formacie JSON zawierającego parametry wywołania.
W celu złożenia zlecenia na integrację danych, należy użyć wywołania POST na adres https://api.transparentdata.pl/key/add
Format zapytania
| Nazwa | Czy wymagany | Opis |
|---|---|---|
source |
tak | Parametr opisujący źródło, z którego należy pozyskać dane |
method |
tak | Metoda, którą należy wywołać w docelowym źródle |
params |
tak | Zestaw parametrów uzależniony od wybranego źródła oraz metody |
W odpowiedzi na wysłane wywołanie, do zadania zostanie przydzielony odpowiedni identyfikator, którym należy się później posługiwać, tak aby uzyskać informacje na temat statusu zadania i odbierania danych wynikowych.
Endpoint /result
Endpoint służy do sprawdzania statusu zadania oraz do pobierania wyniku. Wystarczy wywołać adres URL z identyfikatorem, który został zwrócony przy tworzeniu zadania.
Status może przyjmować następujące wartości:
| Nazwa | Opis |
|---|---|
quened |
Zadanie jest obecnie przetwarzane |
done |
Zadanie jest zakończone |
error |
Wystąpił błąd podczas przetwarzania zadania |
Przykładowe wywołanie:
curl --user:pass https://api.transparentdata.pl/key/result?ident=a4a69bb9-8619-4927-89c5-e03e30f69897
Przykładowa odpowiedź gdy status
queued:
{
"status": "quened",
"ident": "a4a69bb9-8619-4927-89c5-e03e30f69897"
}
Przykładowa odpowiedź gdy status
done:
{
"status": "done",
"ident": "a4a69bb9-8619-4927-89c5-e03e30f69897",
"data": [
{
"source": "ZRODLO_DANYCH",
"method": "NAZWA_METODY",
"params": {
"PARAMETR": 1
},
"result": {
"WYNIK": 123
}
}
]
}
Endpointy Monitoring
Endpoint /monitoringNew
Endpoint służy do tworzenia zleceń nowych monitoringów.
Zakładanie nowego monitoringu.
Aby poprawnie dodać nowy monitoring można skorzystać z cURL.
| Nazwa | Opis |
|---|---|
user |
nazwa użytkownika otrzymana przy zakładaniu api |
pass |
hasło otrzymane przy zakładaniu api |
key |
klucz otrzymany przy zakładaniu api |
Przykładowy Curl
curl -X POST -u user:pass 'http://api.transparentdata.pl/key/monitoringNew' \
-d '{
"name": "Test Api",
"email": "example@example.pl",
"nips": ["7740001454"],
"options": ["monitoring_bankruptcy"],
"notification": "daily"
}'
Przykładowy JSON który należy wysłać do API
{
"name": "Test",
"email": "test@test.pl",
"nips": ["1234567890", "0987654321"],
"options": ["monitoring_bankruptcy"],
"notification": "daily"
}
Format zapytania
| Nazwa | Czy wymagany | Opis |
|---|---|---|
name |
tak | Nazwa własna monitoringu nadawana przez użytkownika |
email |
tak | Adres email, na który wysyłane będą wiadomości email z alertem o zachodzących zmianach |
nips |
tak | Zestaw numerów NIP, KRS lub numerów ksiąg wieczystych, które mają być monitorowane |
options |
tak | Parametry monitorowania |
notification |
nie | Częstotliwość powiadomien, możliwe wartości daily lub after_changes. Domyślnie: after_changes |
Parametry monitorowania
| Nazwa | Opis |
|---|---|
monitoring_bankruptcy |
Monitoring upadłości - zwraca informacje o wszystkich zmianach dotyczących procesu upadłości danego podmiotu |
monitoring_company_liquidation |
Monitoring likwidacji - zwraca informacje o wszystkich zmianach dotyczących procesu likwidacji danego podmiotu |
monitoring_company_restructuring |
Monitoring restrukturyzacji - zwraca informacje o wszystkich zmianach dotyczących procesu restrukturyzacji danego podmiotu |
monitoring_company_management |
Monitoring zarządu - zwraca informacje o wszystkich zmianach dotyczących składu zarządu danego podmiotu |
monitoring_company_capital |
Monitoring kapitału zakładowego - zwraca informacje o wszystkich zmianach wysokości kapitału zakładowego danego podmiotu |
monitoring_company_status |
Monitoring statusu podmiotu - informujemy o wszystkich zmianach dotyczących statusu działalnośći podmiotu |
monitoring_kw |
Monitoring ksiąg wieczystych - zwraca informacje o wszystkich zmianach dotyczących wpisów do Ksiąg Wieczystych |
Parametr notification dostępne wartości
| Rodzaj | Opis |
|---|---|
daily |
Powiadomienie wysyłane jest raz dziennie z kompletem informacji |
after_changes |
Powiadomienie wysyłane jest jedyne wtedy gdy wykryta zostanie zmiana |
W odpowiedzi na zapytanie, zostanie przydzielony identyfikator utworzonego monitoringu.
Odpowiedź
| Nazwa | Opis |
|---|---|
id |
Unikalny numer id monitoringu |
Przykładowa odpowiedź
{
"user_ident": "XXXXX",
"status": "done",
"message": null,
"result": {
"id": 55
}
}
Przykładowa odpowiedź status błedu
{
"status": "error",
"message": "No items was given"
}
Endpoint /monitoringStop
Endpoint służy do zatrzymania działania wybranego monitoringu. W tym celu należy wykorzystać unikalny id monitoringu otrzymany podczas zakładania monitoringu.
Przykładowy Curl
curl -X POST -u user:pass 'http://api.transparentdata.pl/key/monitoringStop' -d '{"id": "1"}'
Odpowiedź
| Nazwa | Opis |
|---|---|
id |
Unikalny numer id monitoringu zatrzymanego |
Przykładowy JSON który należy wysłać do API
{
"id": "1"
}
Przykładowy odpowiedź
{
"user_ident": "XXX",
"status": "done",
"message": null,
"result": {
"id": 3
}
}
Przykładowa odpowiedź status błedu
{
"status": "error",
"message": "Can not stop monitoring in status: deleting"
}
Endpoint /monitoringStart
Endpoint służy do wznowienia działania wybranego monitoringu. W tym celu należy wykorzystać unikalny id monitoringu.
Przykładowy Curl
curl -X POST -u user:pass 'http://api.transparentdata.pl/key/monitoringStart' -d '{"id": "1"}'
Odpowiedź
| Nazwa | Opis |
|---|---|
id |
Unikalny numer id monitoringu wznowionego |
Przykładowy JSON który należy wysłać do API
{
"id": "1"
}
Przykładowy odpowiedź
{
"user_ident": "XXX",
"status": "done",
"message": null,
"result": {
"id": 1
}
}
Przykładowa odpowiedź status błedu
{
"status": "error",
"message": "There is no monitoring with that id"
}
Endpoint /monitoringDelete
Endpoint służy do usunięcia wybranego monitoringu. W tym celu należy wykorzystać unikalny id monitoringu.
Przykładowy Curl
curl -X POST -u user:pass 'http://api.transparentdata.pl/key/monitoringDelete' -d '{"id": "1"}'
Odpowiedź
| Nazwa | Opis |
|---|---|
id |
Unikalny numer id monitoringu usuniętego |
Przykładowy JSON który należy wysłać do API
{
"id": "1"
}
Przykładowy odpowiedź
{
"user_ident": "XXX",
"status": "done",
"message": null,
"result": {
"id": 1
}
}
Przykładowa odpowiedź status błedu
{
"status": "error",
"message": "There is no monitoring with that id"
}
Endpoint /monitoringOrderReport
Endpoint służy do zamówienia raportu (stan obecny) o podanym id monitoringu.
Przykładowy Curl
curl -X POST -u user:pass 'http://api.transparentdata.pl/key/monitoringOrderReport' -d '{"id": "1"}'
Odpowiedź
| Nazwa | Opis |
|---|---|
created_at |
Data utworzenia |
id |
Unikalny numer id raportu zamówionego |
Przykładowy JSON który należy wysłać do API
{
"id": "4"
}
Przykładowa odpowiedź
{
"user_ident": "XXX",
"status": "done",
"message": null,
"result": {
"created_at": "2020-05-06 12:27:58",
"id": "4"
}
}
Przykładowa odpowiedź - status błędu
{
"status": "error",
"message": "There is no monitoring with that id"
}
Endpoint /monitoringGetReport
Endpoint służy do pobrania raportu zamówionego za pomocą endpoint 'monitoringOrderStatus' i zwracanego z niego id z tablicy result.
Przykładowy Curl
curl -X POST -u user:pass 'http://api.transparentdata.pl/key/monitoringGetReport' -d '{"id": "1"}'
W odpowiedzi dostajemy rezultat z plikiem zakodowanym w base64 w rozszerzeniu zip.
Odpowiedź
| Nazwa | Opis |
|---|---|
created_at |
Data utworzenia |
file |
Paczka zip zakodowana w formacie base64 |
Przykładowy JSON który należy wysłać do API
{
"id": "12"
}
Przykładowa odpowiedź
{
"user_ident": "XXX",
"status": "done",
"message": null,
"result": {
"created_at": "2020-04-29 13:07:35",
"file": "UEsDBBQAAAgAAGBfXk+8bKu2EgAAABIAAAAcAAAATW9uaXRvcmluZyAtIFVwYWTFgm/Fm8SHLmNzdjcxMjAxNjA2Nzg7YWt0eXduYVBLAwQUAAAIAABgX15Pw+tZjhYAAAAWAAAAGAAAAE1vbml0b3JpbmcgLSBaYXJ6xIVkLmNzdjcxMjAxNjA2Nzg7QnJhayBkYW55Y2hQSwMEFAAACAAAYF9eT8PrWY4WAAAAFgAAACQAAABNb25pdG9yaW5nIC0gS2FwaXRhxYIgemFrxYJhZG93eS5jc3Y3MTIwMTYwNjc4O0JyYWsgZGFueWNoUEsDBBQAAAAAAGBfXk8AAAAAAAAAAAAAAAAbAAAATW9uaXRvcmluZyAtIExpa3dpZGFjamEuY3N2UEsDBBQAAAAAAGBfXk8AAAAAAAAAAAAAAAAhAAAATW9uaXRvcmluZyAtIFJlc3RydWt0dXJ5emFjamEuY3N2UEsBAhQDFAAACAAAYF9eT7xsq7YSAAAAEgAAABwAAAAAAAAAAAAAALaBAAAAAE1vbml0b3JpbmcgLSBVcGFkxYJvxZvEhy5jc3ZQSwECFAMUAAAIAABgX15Pw+tZjhYAAAAWAAAAGAAAAAAAAAAAAAAAtoFMAAAATW9uaXRvcmluZyAtIFphcnrEhWQuY3N2UEsBAhQDFAAACAAAYF9eT8PrWY4WAAAAFgAAACQAAAAAAAAAAAAAALaBmAAAAE1vbml0b3JpbmcgLSBLYXBpdGHFgiB6YWvFgmFkb3d5LmNzdlBLAQIUAxQAAAAAAGBfXk8AAAAAAAAAAAAAAAAbAAAAAAAAAAAAAAC2gfAAAABNb25pdG9yaW5nIC0gTGlrd2lkYWNqYS5jc3ZQSwECFAMUAAAAAABgX15PAAAAAAAAAAAAAAAAIQAAAAAAAAAAAAAAtoEpAQAATW9uaXRvcmluZyAtIFJlc3RydWt0dXJ5emFjamEuY3N2UEsFBgAAAAAFAAUAegEAAGgBAAAAAA=="
}
}
Przykładowa odpowiedź - status błędu
{
"status": "error",
"message": "There is no report with that id"
}
Endpoint /monitoringGetListMonitoringByStatus
Endpoint służy do pobrania listy monitoringów utworzonych przez użytkownika.
Przykładowy Curl
curl -X GET -u user:pass 'http://api.transparentdata.pl/key/monitoringGetListMonitoringByStatus'
W odpowiedzi otrzymujemy listę monitoringów aktywnych oraz monitoringów, które zostały zatrzymane przez użytkownika.
Odpowiedź
| Nazwa | Opis |
|---|---|
id |
Unikalny numer id monitoringu |
name |
Nazwa monitoringu nadana przez użytkownika |
created_at |
Data utworzenia |
status |
Status raportu: working, stopped |
Przykładowa odpowiedź
{
"user_ident": "XXX",
"status": "done",
"message": null,
"result": [
{
"id": 3,
"name": "monitoring status moj",
"created_at": "2020-04-28 14:57:50",
"status": "working"
},
{
"id": 5,
"name": "WA1M/00060159/1",
"created_at": "2020-04-30 10:34:17",
"status": "working"
},
{
"id": 20,
"name": "sample",
"created_at": "2020-04-30 11:37:09",
"status": "working"
},
{
"id": 21,
"name": "WA2M/00053285/8",
"created_at": "2020-04-30 12:02:57",
"status": "working"
},
{
"id": 22,
"name": "Testowe 2 pusty",
"created_at": "2020-05-05 09:25:28",
"status": "working"
}
]
}
Przykładowa odpowiedź - status błędu
{
"status": "error",
"message": "There is no result"
}
Endpoint /monitoringGetListReportByStatus
Endpoint służy do pobrania listy raportów zamówionych przez użytkownika.
Przykładowy Curl
curl -X GET -u user:pass 'http://api.transparentdata.pl/key/monitoringGetListReportByStatus'
W odpowiedzi dostajemy listę raportów ukończonych, zakończonych błędem lub w przygotowaniu.
Odpowiedź
| Nazwa | Opis |
|---|---|
id |
Unikalny numer id raportu |
created_at |
Data utworzenia |
status |
Status raportu: done, error lub preparing |
Przykładowa odpowiedź
{
"user_ident": "XXX",
"status": "done",
"message": null,
"result": [
{
"id": 3,
"created_at": "2020-04-29 12:43:19",
"status": "done"
},
{
"id": 6,
"created_at": "2020-04-29 13:07:35",
"status": "done"
}
]
}
Przykładowa odpowiedź - status błędu
{
"status": "error",
"message": "There is no result"
}
Endpoint /monitoringGetListNewNotifications
Endpoint służy do pobrania listy notyfikacji.
Przykładowy Curl
curl -X POST -u user:pass 'http://api.transparentdata.pl/key/monitoringGetListNewNotifications' -d '{"page": "1"}'
| Nazwa | Opis |
|---|---|
page |
Numer strony do wyświetlenia |
Przykładowy JSON który należy wysłać do API
{
"page": "1"
}
W odpowiedzi otrzymujemy listę notyfikacji powstałych w przeciągu ostatnich 7 dni.
Odpowiedź
| Nazwa | Opis |
|---|---|
user_ident |
Id użytkownika |
status |
done lub error |
message |
W przypadku statusu error informacja inaczej null |
current_page |
Numer podanej strony |
id |
Unikalny numer id notyfikacji służący do pobrania szczegółów np. KW |
created_at |
Data utworzenia monitoringu |
monitoring_type |
Typ monitoringu dla KW będzie monitoring_kw |
monitoring_id |
Unikalny numer id monitoringu (monitoring_set) nadany przy zakładaniu monitoringu |
from |
Numer początkowy strony |
last_page |
Numer ostatniej strony |
per_page |
Ilość na stronie |
to |
Ostatni numer na stronie |
total |
Całkowita ilość ident |
Przykładowa odpowiedź
{
"user_ident": "XXXX",
"status": "done",
"message": null,
"result": {
"current_page": 1,
"data": [
{
"id": "24232",
"created_at": "2020-05-19 21:17:37",
"monitoring_type": "monitoring_company_status",
"monitoring_id": 76
},
{
"id": 359215,
"created_at": "2020-05-19 22:19:46",
"monitoring_type": "monitoring_company_status",
"monitoring_id": 76
},
{
"id": 359217,
"created_at": "2020-05-19 22:19:46",
"monitoring_type": "monitoring_company_status",
"monitoring_id": 95
},
{
"id": 359221,
"created_at": "2020-05-19 22:19:48",
"monitoring_type": "monitoring_company_status",
"monitoring_id": 76
},
{
"id": 359223,
"created_at": "2020-05-19 22:19:49",
"monitoring_type": "monitoring_company_status",
"monitoring_id": 76
},
{
"id": 359224,
"created_at": "2020-05-19 22:19:50",
"monitoring_type": "monitoring_company_status",
"monitoring_id": 76
},
{
"id": 359225,
"created_at": "2020-05-19 22:19:50",
"monitoring_type": "monitoring_company_status",
"monitoring_id": 95
},
{
"id": 359226,
"created_at": "2020-05-19 22:19:51",
"monitoring_type": "monitoring_company_status",
"monitoring_id": 76
},
{
"id": 620476,
"created_at": "2020-05-20 14:06:03",
"monitoring_type": "monitoring_company_status",
"monitoring_id": 73
},
{
"id": 620477,
"created_at": "2020-05-20 14:06:03",
"monitoring_type": "monitoring_company_status",
"monitoring_id": 76
},
{
"id": 661130,
"created_at": "2020-05-20 15:43:24",
"monitoring_type": "monitoring_company_status",
"monitoring_id": 76
},
{
"id": 661132,
"created_at": "2020-05-20 15:43:24",
"monitoring_type": "monitoring_company_status",
"monitoring_id": 95
},
{
"id": 680081,
"created_at": "2020-05-20 16:16:13",
"monitoring_type": "monitoring_kw",
"monitoring_id": 76
}
],
"from": 1,
"last_page": 1,
"per_page": 10000,
"to": 13,
"total": 13
}
}
Przykładowa odpowiedź - status błędu
{
"status": "error",
"message": "There is now result"
}
Endpoint /monitoringGetKwDetails
Endpoint służy do pobrania szczegółów notyfikacji dla KW.
Przykładowy Curl
curl -X POST -u user:pass 'http://api.transparentdata.pl/key/monitoringGetKwDetails' -d '{"id": "723"}'
W odpowiedzi uzyskujemy link do www z widokiem zmian, nazwy działów w których nastąpiły zmiany oraz html ze zmianami kw.
Zapytanie
| Nazwa | Opis |
|---|---|
id |
Unikalny numer id notifikacji dostępny po wywołaniu endpoint /monitoringGetListNewNotifications gdzie monitoring_type "monitoring_kw" |
Odpowiedź
| Nazwa | Opis |
|---|---|
name |
Nazwa monitornigu podana w trakcie zakładani |
ident |
Numer księgi wieczystej |
created_at |
Data utworzenia |
link |
Link do wersji zmian |
depertment |
Działy w których nastąpiła zmiana |
table_html |
Kod html strony działów w których nastąpiły zmiany przed i po zmianach. |
Treści statusów error:
There is no id given
There is no result
You have no access to this record
Incorrect monitoring type
Przykładowy JSON który należy wysłać do API
{
"id": "723"
}
Przykładowa odpowiedź
{
"user_ident": "XXXX",
"status": "done",
"message": null,
"result": {
"id": 723,
"name": "nazwa monitoringu",
"ident": "nazwa kw",
"created_at": "2020-05-01 08:18:30",
"link": "https://di.transparentdata.pl/monitoring-szczegoly/kw/723",
"html": {
"department": [
"Dział I-O",
"Dział II",
"Dział III"
],
"tables_html": [
{
"before": "<!DOCTYPE html><body>Html przed zmianami</body></html>",
"after": "<!DOCTYPE html><body>Html po zmianach</body></html>"
},
{
"before": "<!DOCTYPE html><body>Html przed zmianami</body></html>",
"after": "<!DOCTYPE html><body>Html po zmianach</body></html>"
},
{
"before": "<!DOCTYPE html><body>Html przed zmianami</body></html>",
"after": "<!DOCTYPE html><body>Html po zmianach</body></html>"
}
]
}
}
}
Przykładowa odpowiedź - status błędu
{
"status": "error",
"message": "There is no id given"
}
Endpoint /monitoringGetListIdents
Endpoint służy do pobrania listy idents (numerów nip/ numerów kw) utworzonych przez użytkownika dla podanego numeru id monitoringu oraz numeru strony.
Przykładowy Curl
curl -X POST -u user:pass 'http://api.transparentdata.pl/key/monitoringGetListIdents' -d '{"id": "119", "page": "1"}'
W zapytaniu należy podać unikalny numer id monitoringu oraz numer strony do zwrócenia
| Nazwa | Opis |
|---|---|
id |
Unikalny numer id monitoringu |
page |
Numer strony do zwrócenia |
Przykładowy JSON który należy wysłać do API
{
"id": "119",
"page": "1"
}
Odpowiedź
W odpowiedzi otrzymujemy listę idents (numerów nip/ numerów kw) dla podanego numeru id monitoringu.
| Nazwa | Opis |
|---|---|
status |
done lub error |
message |
W przypadku statusu error informacja inaczej null |
created_at |
Data utworzenia monitoringu |
monitoring_id |
Unikalny numer id monitoringu |
current_page |
Numer podanej strony |
ident |
Numer NIP/KW |
from |
Numer początkowy strony |
last_page |
Numer ostatniej strony |
per_page |
Ilość na stronie |
to |
Ostatni numer na stronie |
total |
Całkowita ilość ident |
Przykładowa odpowiedź
{
"user_ident": "XXXXX",
"status": "done",
"message": null,
"result": {
"created_at": "2020-05-06 17:21:14",
"monitoring_id": 119,
"result": {
"current_page": 1,
"data": [
{
"ident": "0000000007"
},
{
"ident": "0000000007"
}
],
"from": 1,
"last_page": 1,
"per_page": 10000,
"to": 1,
"total": 2
}
}
}
Przykładowa odpowiedź - status błędu
{
"status": "error",
"message": "There is no monitoring with that id"
}
Endpoint /monitoringUpdate
Endpoint służy do zmian w utworzonym monitoringu. Za pomocą niego możemy usuwać lub dodawać ident - numery (nip lub ksiąg wieczystych).
W tym celu należy wykorzystać unikalny id monitoringu (zwrócony w trakcie zakładania monitoringu) oraz podać wartości w tablicy do dodania lub usunięcia.
Przykładowy Curl
curl -X POST -u user:pass 'http://api.transparentdata.pl/key/monitoringUpdate' -d '{"id": "62", "add": ["6751373354"], "delete":["6751373354"]}'
| Nazwa | Opis |
|---|---|
id |
Id monitoringu |
add |
Tablica z numerami do dodania, jeżeli brak wartości można pominąć w zapytaniu klucz |
delete |
Tablica z numerami przeznaczonymi do usunięcia, jeżeli brak wartości można pominąć w zapytaniu klucz |
Odpowiedź
| Nazwa | Opis |
|---|---|
status |
Status wykonania done lub error |
message |
W przypadku niepowodzenia (status error) informacja zwrotna o przyczynach inaczej null. |
result |
Pusta tablica. |
Przykładowy JSON który należy wysłać do API
{
"id": "62",
"add": ["6751373354"],
"delete": ["6751373354"]
}
Przykładowy odpowiedź
{
"user_ident": "[key]",
"status": "done",
"message": null,
"result": []
}
Przykładowa odpowiedź status błedu
{
"status": "error",
"message": "There is no monitoring with that id"
}
Uwierzytelnianie
Aby mieć dostęp do poszczególnych zasobów danych, API Transparent Data wymaga uwierzytelnienia. Uwierzytelnienie jest realizowane za pomocą standardowych mechanizmów HTTP Basic Auth.
Każdy użytkownik dostaje swój indywidualny adres url, pod którym dostępne są wszystkie adresy wymienione poniżej.
Jeżeli nie jesteś jeszcze naszym Klientem, a interesuje Cię dostęp do API, opisz nam swoje potrzeby biznesowe w formularzu kontaktowym poprzez stronę https://transparentdata.pl/kontakt/
Przykład uwierzytelniania:
curl --user login:pass https://api.transparentdata.pl/key/
Autoryzowanie loginem i hasłem
Każdemu użytkownik otrzymuje zestaw parametrów wymaganych do uruchomienia usługi:
| Nazwa | Opis |
|---|---|
key |
Unikalny klucz, który jest fragmentem adresu url |
user |
Nazwa użytkownika |
pass |
Hasło wymagane do uwierzytelnienia |
Powyższy zestaw parametrów jest wystarczający, aby w łatwy sposób rozpocząć pobieranie danych z bazy Transparent Data. Wszystkie wywołania API działają z SSL.
Działanie API można sprawdzić również w przeglądarce internetowej przez wywołanie adresu zbudowanego według wzorca: https://user:pass@api.transparentdata.pl/key/
Autoryzowanie mechanizmem JWT
W ramach integracji użytkownik może skorzystać z autoryzacji JWT. W tym przypadku zostaną mu udostępnione następujące parametry:
| Nazwa | Opis |
|---|---|
key |
Unikalny klucz, który jest fragmentem adresu url |
secret_key |
Unikalny ciąg znaków, służący do podpisywania wywołań do API |
Szczegółowy opis JWT jest dostępny https://en.wikipedia.org/wiki/JSON_Web_Token
Przygotowanie struktury do podpisania
Struktura header
{
"alg" : "HS256",
"typ" : "JWT"
}
Wymagane elementy payload
| Nazwa | Opis |
|---|---|
exp |
Timestamp, po którym token traci ważność |
iat |
Timestamp, zawierający datę, w której token został utworzony |
{
"exp" : "1558523523",
"iat" : "1558523503"
}
W ramach payload można także przekazać dodatkowe parametry, które zostaną przekazane do metody w niezmienionej postaci. Przykładowa struktura takiego zapytania może wyglądać następująco:
{
"exp" : "1558523523",
"iat" : "1558523503",
"nip" : "123123123"
}
Wyliczenie signature
W PHP może wyglądać następująco:
$signature = hash_hmac('sha256', base64_encode($header) . '.' . base64_encode($payload), $secretKey, true);
Utworzenie tokenu
$token = base64_encode($header) . '.' . base64_encode($payload) . '.' . base64_encode($signature);
Przykładowy token wygląda następująco:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsb2dnZWRJbkFzIjoiYWRtaW4iLCJpYXQiOjE0MjI3Nzk2Mzh9.gzSraSYS8EXBxLN_oWnFSRgCzcmJmMjLiuyu5CSpyHI
Podpisywanie wywołania
Podczas wywołania, API Transparent Data sprawdza czy dodany został nagłówek
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsb2dnZWRJbkFzIjoiYWRtaW4iLCJpYXQiOjE0MjI3Nzk2Mzh9.gzSraSYS8EXBxLN_oWnFSRgCzcmJmMjLiuyu5CSpyHI
Jeżeli nagłówek został dodany, to sprawdzana jest sygnatura i czasy generowania, tak aby zweryfikować poprawność tokenu. Jeśli wszystko przebiegło poprawnie, wybrana metoda zostanie wywołana.
Przykładowe generowanie tokenu w PHP
$secretKey = 'abc';
$header = json_encode(['alg' => 'HS256', 'typ' => 'JWT']);
$payload = json_encode(['exp' => time() + 60, 'iat' => time()]); // czas ważności 60 sek
$signature = hash_hmac('sha256', base64_encode($header) . '.' . base64_encode($payload), $secretKey, true);
$token = base64_encode($header) . '.' . base64_encode($payload) . '.' . base64_encode($signature);
echo $token;
Dostępne źródła danych
BIG KRD
Podstawowe API Biura Informacji Kredytowej BIG S.A. pozwala na sprawdzanie informacji na temat firm i osób prywatnych w bazie KRD.
KRD udostępnia w tym celu dwie metody: SearchConsumer oraz SearchNonConsumer. Aby skorzystać z tych metod w ramach Data Integratora, należy wysłać zapytanie według formatu poniżej.
Opis parametrów jest zgodny z dokumentacją udostępnioną przez KRD: http://info.krd.pl/Programista/Dokumentacja-techniczna/Chase
SearchConsumer
Przykładowe zapytanie
{
"source":"krd_chase",
"method":"SearchConsumer",
"params":{
"Number":"11223344556",
"NumberType":"Pesel",
"AuthorizationDate":"2018-11-21T08:33:33"
}
}
SearchNonConsumer
{
"source":"krd_chase",
"method":"SearchNoneConsumer",
"params":{
"Number":"11223344556",
"NumberType":"TaxId",
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "a4a69bb9-8619-4927-89c5-e03e30f69897"
}
W celu pobrania zestawu danych zwracanych przez KRD, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=a4a69bb9-8619-4927-89c5-e03e30f69897
Przykładowy zestaw danych
{
"status": "done",
"ident": "a4a69bb9-8619-4927-89c5-e03e30f69897",
"added":"2018-12-07 09:59:39",
"finished":"2018-12-07 09:59:40",
"user_account":null,
"progress":100,
"data": [
{
"source": "krd_chase",
"method": "SearchConsumer",
"params": {
"Number": "11223344556",
"NumberType": "Pesel",
"AuthorizationDate": "2018-11-11T08:33:33"
},
"meta":null,
"result": {
"DisclosureReport": {
"Number": "U1/0000541758/2018",
"Created": "2018-11-20T13:43:53+01:00",
"SearchCriterion": {
"ConsumerIdentityNumber": {
"Pesel": "11223344556"
},
"AuthorizationDate": "2018-11-11T00:00:00+01:00",
"AuthorizationDateSpecified": true,
"ActAuthorizationDateSpecified": false,
"SearchType": "RegularSearch",
"SearchCriterionType": "Pesel"
},
"Requester": {
"LegalPerson": {
"Name": "KLIENT DEMO_CHASE3.1",
"IdentityNumber": {
"TaxId": "5327161905"
},
"SeatAddress": {
"Line": [
"Danuty Siedzikówny 12, Wrocław",
"51-214 Wrocław",
"PL"
]
}
},
"LoginFullName": "KLIENT DEMO_CHASE3.1"
},
"Summary": {
"InformationCount": 1,
"OInformationCount": 1,
"DInformationCount": 0,
"DebtorsCount": 1,
"CreditorsCount": 1,
"TotalArrears": {
"Amount": "658.25",
"Currency": "PLN"
}
},
"PositiveInformationSummary": {
"ProvidersCount": 0,
"PaidObligationsCount": 0,
"AveragePaidDebt": "0",
"AveragePaymentTimeInDays": 0,
"SumPaidDebt": "0"
},
"Report": {
"ObligationInformations": {
"ObligationInformation": {
"Debtor": {
"Consumer": {
"FirstName": "Mariusz",
"Surname": "Staszewski",
"IdentityNumber": {
"Pesel": "11223344556"
},
"Address": {
"Line": [
"Olszewskiego 2/2",
"26-610 Radom",
"PL"
]
}
}
},
"Provider": {
"LegalPerson": {
"Name": "KLIENT DEMO_CHASE3.1",
"IdentityNumber": {
"TaxId": "5327161905"
},
"SeatAddress": {
"Line": [
"Danuty Siedzikówny 12, Wrocław",
"51-214 Wrocław",
"PL"
]
},
"Regon": "391687011"
},
"category": 0
},
"Title": "Pożyczka gotówkowa",
"Type": "Other",
"CustomType": "Inne",
"PaymentDate": "2016-06-06T00:00:00+02:00",
"NoObjections": true,
"CallSent": "2016-06-06T00:00:00+02:00",
"Arrears": {
"Amount": "658.25",
"Currency": "PLN"
},
"category": 13
}
}
}
}
}
}
]
}
TD - Pełen odpis KRS PDF
Źródło danych umożliwia pobranie pełnych odpisów KRS w formie plików PDF ze strony Krajowego Rejestru Sądowego, prowadzonego przez Ministerstwo Sprawiedliwości.
Przykładowe zapytanie
{
"source":"krs_full",
"method":"pdf",
"params":{
"nip":"123123123"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
W celu pobrania zestawu danych zwracanych przez KRS, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1
W ramach odpowiedzi, użytkownik otrzyma zakodowany w Base64 plik z odpisem.
Przykładowy zestaw danych wywołując metode /result
{
"status":"done",
"ident":"63eb039d-9039-4e6c-a1a2-924e348c18c1",
"added":"2018-12-07 09:59:39",
"finished":"2018-12-07 09:59:40",
"user_account":null,
"progress":100,
"data":[
{
"task_id":171,
"source":"krs_full",
"method":"pdf",
"params":{
"nip":"9721286534"
},
"meta":null,
"result":{
"file":"JVBERJGLCB....T0YK",
"added":"2018-11-09 14:56:19"
}
}
]
}
TD - Odpis KRS PDF
Źródło danych umożliwia pobranie skróconych odpisów KRS w formie plików PDF ze strony Krajowego Rejestru Sądowego, prowadzonego przez Ministerstwo Sprawiedliwości.
Przykładowe zapytanie
{
"source":"krs",
"method":"pdf",
"params":{
"nip":"123123123",
"timeout": 300
}
}
Parametr timeout, określający maksymalny czas oczekiwania na odświeżenie danych, nie jest wymagany. Domyślna wartość to 300 sekund.
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
W celu pobrania zestawu danych zwracanych przez KRS, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1
W ramach odpowiedzi, użytkownik otrzyma zakodowany w Base64 plik z odpisem.
Przykładowy zestaw danych wywołując metode /result
{
"status":"done",
"ident":"63eb039d-9039-4e6c-a1a2-924e348c18c1",
"added":"2018-12-07 09:59:39",
"finished":"2018-12-07 09:59:40",
"user_account":null,
"progress":100,
"data":[
{
"task_id":171,
"source":"krs",
"method":"pdf",
"params":{
"nip":"9721286534"
},
"meta":null,
"result":{
"file":"JVBERJGLCB....T0YK",
"added":"2018-11-09 14:56:19"
}
}
]
}
TD - Odpis KRS JSON
Źródło umożliwia pobranie wszystkich danych o podmiocie ze skróconego odpisu KRS w formacie JSON.
Odpisy KRS pochodzą ze strony Krajowego Rejestru Sądowego, prowadzonego przez Ministerstwo Sprawiedliwości.
Przykładowe zapytanie
{
"source":"krs",
"method":"data",
"params":{
"nip":"123123123",
"timeout": 200
}
}
Parametr timeout, określający maksymalny czas oczekiwania na odświeżenie danych, nie jest wymagany. Domyślna wartość to 200 sekund.
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
W celu pobrania zestawu danych, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1
Przykładowy zestaw danych wywołując metode /result
{
"status": "done",
"ident": "76312054-e100-478d-8854-0f68eda244e4",
"user_account": null,
"progress": 100,
"data": [
{
"task_id": 6865,
"source": "krs",
"method": "data",
"params": {
"nip": "7740001454"
},
"meta": null,
"result": {
"data_acquisition_date": "2019-09-17",
"name": "POLSKI KONCERN NAFTOWY ORLEN SPÓŁKA AKCYJNA",
"legal_form": "SPÓŁKA AKCYJNA",
"krs": "0000028860",
"nip": "7740001454",
"regon": "610188201",
"company_status": "Aktywny",
"address": {
"street": "ul. CHEMIKÓW",
"number": "7",
"local": null,
"postcode": "09-411",
"post": "PŁOCK-BIAŁA",
"city": "PŁOCK",
"county": "M. PŁOCK",
"region": "MAZOWIECKIE",
"country": "POLSKA"
},
"equity": "534636326.25",
"stock": {
"quantity": "427709061",
"value": "1.25"
},
"incorporation": "2001-07-19",
"created_at": "1993-06-29",
"last_registry_update": "2018-10-08",
"removed_at": null,
"opp": false,
"opp_start": null,
"pkd": "1920Z",
"representation": "- DWAJ CZŁONKOWIE ZARZĄDU DZIAŁAJĄCY ŁĄCZNIE\n- CZŁONEK ZARZĄDU DZIAŁAJĄCY ŁĄCZNIE Z PROKURENTEM\nDO ZACIĄGANIA ZOBOWIĄZAŃ I DOKONYWANIA CZYNNOŚCI ROZPORZĄDZAJĄCYCH ZWYKŁEGO\nZARZĄDU O WARTOŚCI NIE PRZEKRACZAJĄCEJ 100.000 /STO TYSIĘCY/ ZŁOTYCH\nWYSTARCZAJĘCE JEST OŚWIADCZENIE WOLI I PODPIS JEDNEGO CZŁONKA ZARZĄDU.",
"representation_body": "ZARZĄD PKN ORLEN S.A.",
"supervisory_authority": "RADA NADZORCZA",
"in_bankruptcy": false,
"liquidation_start": null,
"liquidation_end": null,
"liquidation_representation": null,
"court": {
"name": "SĄD REJONOWY DLA M. ST. WARSZAWY W WARSZAWIE, XIV WYDZIAŁ GOSPODARCZY KRAJOWEGO REJESTRU SĄDOWEGO",
"ident": "WA.XIV NS-REJ.KRS/32962/18/825"
},
"www": "WWW.ORLEN.PL",
"email": "ZARZAD@ORLEN.PL",
"relation": [
{
"name": "JAN MARIA KOWALSKI",
"first_name": "JAN MARIA",
"last_name": "KOWALSKI",
"relation": "board_member",
"relation_extra_info": "CZŁONEK ZARZĄDU",
"ident": {
"name": "pesel",
"value": "64051132356"
}
},
{
"name": "JANINA JEŻYNA KOWALSKA",
"first_name": "JANINA JEŻYNA",
"last_name": "KOWALSKA",
"relation": "proxy",
"relation_extra_info": "PROKURA SAMOISTNA",
"ident": {
"name": "pesel",
"value": "57082748528"
}
},
{
"name": "STANISŁAW ZIEMOMYSŁ NOWAK",
"first_name": "STANISŁAW ZIEMOMYSŁ",
"last_name": "NOWAK",
"relation": "supervisory_board_member",
"relation_extra_info": "",
"ident": {
"name": "pesel",
"value": "56092932473"
}
}
],
"krs_debts": [
{
"amount": "121323.90",
"date": "2012-06-11",
"debt_info": "NA RZECZ ZUS",
"debt_extra_info": "DYREKTOR ZAKŁADU UBEZPIECZEŃ SPOŁECZNYCH III ODDZIAŁ W WARSZAWIE, 11.01.2011, TW 2443242"
}
]
}
}
]
}
TD - KRS Powiązania firm JSON
Źródło umożliwia pobranie informacji o powiązaniach danej firmy z innymi podmiotami gospodarczymi i osobami z KRS w formacie JSON.
Przykładowe zapytanie
{
"source":"krs",
"method":"getKrsConnectionsForCompany",
"params":{
"nip":"123123123"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
W celu pobrania zestawu danych, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1
Przykładowy zestaw danych wywołując metode /result
{
"status":"done",
"ident":"63eb039d-9039-4e6c-a1a2-924e348c18c1",
"added":"2018-12-07 09:59:39",
"finished":"2018-12-07 09:59:40",
"user_account":null,
"progress":100,
"data": [
{
"task_id": 198,
"source": "krs",
"method": "getKrsConnectionsForCompany",
"params": {
"nip": "123123123"
},
"meta": null,
"result": [
{
"type": "company",
"name": "FIRMA.CO SPÓŁKA AKCYJNA",
"formatted_name": "Firma.Co",
"krs": "123123123",
"nip": "123123123",
"regon": "123123123",
"pesel": null
},
{
"type": "person",
"name": "KATARZYNA NOWAK",
"formatted_name": "Katarzyna Nowak",
"krs": null,
"nip": null,
"regon": null,
"pesel": "xxxxxxxxxxxxxx"
}
]
}
]
}
TD - KRS Powiązania osób JSON
Źródło umożliwia pobranie informacji o powiązaniach danej osoby fizycznej z innymi podmiotami i osobami z KRS w formacie JSON.
Przykładowe zapytanie
{
"source":"krs",
"method":"getKrsConnectionsForPerson",
"params":{
"pesel":"123122232233"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
W celu pobrania zestawu danych, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1
Przykładowy zestaw danych wywołując metode /result
{
"status":"done",
"ident":"63eb039d-9039-4e6c-a1a2-924e348c18c1",
"added":"2018-12-07 09:59:39",
"finished":"2018-12-07 09:59:40",
"user_account":null,
"progress":100,
"data": [
{
"task_id": 198,
"source": "krs",
"method": "getKrsConnectionsForPerson",
"params": {
"pesel": "123122232233"
},
"meta": null,
"result": [
{
"type": "company",
"name": "FIRMA.CO SPÓŁKA AKCYJNA",
"formatted_name": "Firma.Co",
"krs": "12312223",
"nip": "12312223",
"regon": "12312223",
"pesel": null
},
{
"type": "company",
"name": "FIRMA.CO SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ SPÓŁKA KOMANDYTOWA",
"formatted_name": "Firma.Co",
"krs": "12312223",
"nip": "12312223",
"regon": "12312223",
"pesel": null
}
]
}
]
}
TD - Spr finansowe Dostępne zakresy JSON
Źródło umożliwia pobranie dostępnych dla wybranych sprawozdań finansowych zakresów dat w formacie JSON. Sprawozdania finansowe pochodzą z bazy dokumentów finansowych Ministerstwa Sprawiedliwości.
Przykładowe zapytanie
{
"source": "financial_ranges",
"method": "getDateRanges",
"params": {
"input": "123123123"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
W celu pobrania zestawu danych o dostępnych zakresach dat wybranych sprawozdań finansowych oraz otrzymać ich identyfikatory, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1
Przykładowa odpowiedź
{
"status":"done",
"ident":"cc60d88a-f260-4846-bd7c-f0ca982d7063",
"added":"2019-08-06 10:40:04",
"finished":"2019-08-06 10:40:45",
"user_account":null,
"progress":100,
"data":[
{
"task_id":3,
"source":"financial_ranges",
"method":"getDateRanges",
"params":{
"input":"1010005790"
},
"meta":null,
"result":{
"results":{
"377200":{
"statement_id":"377200",
"source":"financial_statement",
"year":"2018",
"date_from":"2018-01-01",
"date_to":"2018-12-31"
}
},
"num_page":null,
"per_page":null,
"total_items":null,
"page_amounts":null,
"status":false
}
}
]
}
TD - Spr finansowe Plik ZIP
Źródło umożliwia pobranie całego kompletu oryginalnie składanych przez firmę dokumentów finansowych dla zadanego numeru NIP oraz wskazanych zakresów dat.
Przykładowe zapytanie
{
"source":"financial_ranges",
"method":"zip",
"params":{
"nip":"123123123"
"dates-ranges": ["2018-01-01|2018-12-31"]
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
W rezultacie, użytkownik otrzyma zakodowany w Base64 plik ZIP z takimi dokumentami z bazy Ministerstwa Sprawiedliwości jak sprawozdania finansowe, sprawozdania z działalności, uchwała o podziale zysku lub straty itp. w formacie, w jakim podmiot je złożył - XLSX, DOC, PDF, TXT.
W celu pobrania pliku ZIP ze sprawozdaniami finansowymi, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1
W odpowiedzi znajdzie się plik z odpisem zakodowany w Base64
Przykładowa odpowiedź
{
"status":"done",
"ident":"bf0ef162-b7ca-4d5a-8b47-edd9fdd71148",
"added":"2019-08-06 10:47:54",
"finished":"2019-08-06 10:48:35",
"user_account":null,
"progress":100,
"data":[
{
"task_id":4,
"source":"financial_ranges",
"method":"zip",
"params":{
"nip":"1010005790",
"dates-ranges":[
"2018-01-01|2018-12-31"
]
},
"meta":null,
"result":{
"file":"UE....",
"name":"financial_a539c19988.zip"
}
}
]
}
TD - Spr finansowe Oryginalne JSON
Źródło umożliwia pobranie danych z oryginalnych sprawozdań finansowych w formacie JSON dla zadanego numeru NIP oraz wskazanych zakresów dat. Sprawozdania finansowe pochodzą z bazy dokumentów finansowych Ministerstwa Sprawiedliwości.
Przykładowe zapytanie
{
"source":"financial_ranges",
"method":"data",
"params":{
"nip":"123123123"
"dates-ranges": ["377200"]
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1
W odpowiedzi otrzymamy dane w formacie JSON
{
"status":"done",
"ident":"1f18b1bf-93c6-43a6-99e5-60788ee20a01",
"added":"2019-08-06 10:55:41",
"finished":"2019-08-06 10:55:53",
"user_account":null,
"progress":100,
"data":[
{
"task_id":5,
"source":"financial_ranges",
"method":"data",
"params":{
"nip":"1010005790",
"dates-ranges":[
"377200"
]
},
"meta":null,
"result":{
"results":{
"nip":"1010005790",
"377200":{
"A. Aktywa trwałe":"9479.61",
"I. Wartości niematerialne i prawne":"0.00",
"1. Koszty zakończonych prac rozwojowych":"0.00",
"2. Wartość firmy":"0.00",
"3. Inne wartości niematerialne i prawne":"0.00",
"4. Zaliczki na wartości niematerialne i prawne":"0.00",
"II. Rzeczowe aktywa trwałe":"9479.61",
"1. Środki trwałe":"0.00",
"a. Grunty w tym prawa wieczyste":"0.00",
"b. Budynki, lokale i obiekty":"0.00",
"c. Urządzenia techniczne i maszyny":"0.00",
"d. Środki transportu":"0.00",
"e. Inne środki trwałe":"0.00",
"2. Środki trwałe w budowie":"3731.61",
"3. Zaliczki na środki trwałe":"5748.00",
"III. Należności długoterminowe":"0.00",
"1. Od jednostek powiązanych":"0.00",
"2. Od pozostałych jednostek":"0.00",
"IV. Inwestycje długoterminowe":"0.00",
"1. Nieruchomości":"0.00",
"2. Wartości niematerialne i prawne":"0.00",
"3. Długoterminowe aktywa finansowe":"0.00",
"a. W jednostkach powiązanych":"0.00",
"i. udziały lub akcje":"0.00",
"ii. inne papiery wartościowe":"0.00",
"iii. udzielone pożyczki":"0.00",
"iv. inne długoterminowe aktywa finansowe":"0.00",
"b. W pozostałych jednostkach":"0.00",
"4. Inne inwestycje długoterminowe":"0.00",
"V. Długoterminowe rozliczenia międzyokresowe":"0.00",
"1. Aktywa z tytułu odroczonego podatku dochodowego":"0.00",
"2. Inne rozliczenia międzyokresowe":"164.00",
"B. Aktywa obrotowe":"71782.08",
"I. Zapasy":"0.00",
"1. Materiały":"0.00",
"2. Półprodukty i produkty w toku":"0.00",
"3. Produkty gotowe":"0.00",
"4. Towary":"0.00",
"5. Zaliczki na dostawy":"0.00",
"II. Należności krótkoterminowe":"15934.68",
"1. Należności od jednostek powiązanych":"0.00",
"a. Z tytułu dostaw i usług w okresie spłaty":"0.00",
"i. Do 12 miesięcy":"4772.02",
"ii. Powyżej 12 miesięcy":"0.00",
"b. Inne":"0.00",
"2. Należności od pozostałych jednostek":"15934.68",
"b. Z tytułu podatków, dotacji, ceł, ZUS":"15934.68",
"c. Inne":"0.00",
"d. Dochodzone na drodze sądowej":"0.00",
"III. Inwestycje krótkoterminowe":"55847.40",
"1. Krótkoterminowe aktywa finansowe":"55847.40",
"i. Udziały lub akcje":"0.00",
"ii. Inne papiery wartościowe":"0.00",
"iii. Udzielone pożyczki":"0.00",
"iv. Inne krótkoterminowe aktywa finansowe":"0.00",
"c. Środki pieniężne i inne aktywa pieniężne":"55847.40",
"i. Środki pieniężne w kasie i na rachunkach":"55847.40",
"ii. Inne środki pieniężne":"0.00",
"iii. Inne aktywa pieniężne":"0.00",
"2. Inne inwestycje krótkoterminowe":"0.00",
"IV. Krótkoterminowe rozliczenia międzyokresowe":"0.00",
"Aktywa razem":"81261.69",
"A. Kapitał (fundusz) własny":"-373674.33",
"I. Kapitał (fundusz) podstawowy":"50000.00",
"II. Należne wpłaty na kapitał podstawowy":"0.00",
"III. Udziały (akcje) własne":"0.00",
"IV. Kapitał (fundusz) zapasowy":"0.00",
"V. Kapitał z aktualizacji wyceny":"0.00",
"VI. Pozostałe kapitały rezerwowe":"0.00",
"VII. Zysk (strata) z lat ubiegłych":"-321935.94",
"VIII. Zysk (strata) netto":"-101738.39",
"B. Zobowiązania i rezerwy na zobowiązania":"454936.02",
"I. Rezerwy na zobowiązania":"0.00",
"2. Rezerwa na świadczenia emerytalne i podobne":"0.00",
"a. Długoterminowa":"0.00",
"b. Krótkoterminowa":"0.00",
"3. Pozstałe rezerwy":"0.00",
"II. Zobowiązania długoterminowe":"450000.00",
"1. Wobec jednostek powiązanych":"0.00",
"2. Wobec pozostałych jednostek":"4772.02",
"a. Kredyty i pożyczki":"0.00",
"b. Z tytułu emisji dłużnych papierów wartościowych":"0.00",
"c. Inne zobowiązania finansowe":"0.00",
"d. Inne":"0.00",
"III. Zobowiązania krótkoterminowe":"4772.02",
"a. Z tytułu dostaw i usług o okresach wymagalności":"0.00",
"d. Z tytułu dostaw i usług o okresach wymagalności":"4772.02",
"e. Zaliczki otrzymane na dostawy":"0.00",
"f. Zobowiązania wekslowe":"0.00",
"g. Z tytułu podatków, ceł, ZUS i innych świadczeń":"0.00",
"h. Z tytułu wynagrodzeń":"0.00",
"i. Inne":"0.00",
"IV. Rozliczenia międzyokresowe":"164.00",
"1. Ujemna wartość firmy":"0.00",
"a. Długoterminowe":"0.00",
"b. Krótkoterminowe":"164.00",
"Pasywa razem":"81261.69",
"A. Przychody netto ze sprzedaży i zrównane z nimi, w tym:":"0.00",
"-od jednostek powiązanych":"0.00",
"I. Przychody netto ze sprzedaży produktów":"0.00",
"II. Zmiana stanu produktów":"0.00",
"III Koszt wytworzenia produktów na własne potrzeby jed.":"0.00",
"IV. Przychody netto ze sprzedaży towarów i materiałów":"0.00",
"B. Koszty działalności operacyjnej":"74308.03",
"I. Amortyzacja":"0.00",
"II. Zużycie materiałów i energii":"28.00",
"III. Usługi obce":"74038.03",
"IV. Podatki i opłaty w tym:":"140.00",
"- podatek akcyzowy":"0.00",
"V. Wynagrodzenia":"0.00",
"VI. Ubezpieczenia społeczne i inne świadczenia":"0.00",
"VII. Pozostałe koszty rodzajowe":"102.00",
"VIII. Wartość sprzedanych towarów i materiałów":"0.00",
"C. Zysk (strata) ze sprzedaży (A-B)":"-74308.03",
"D. Pozostałe przychody operacyjne":"2.79",
"I. Zysk ze zbycia niefinansowych aktywów trwałych":"0.00",
"II. Dotacje":"0.00",
"III. Inne przychody operacyjne":"2.79",
"E. Pozostałe koszty operacyjne":"1.99",
"I. Strata ze zbycia niefinansowych aktywów trwałych":"0.00",
"II. Aktualizacja wartości aktywów niefinansowych":"0.00",
"III. Inne koszty operacyjne":"1.99",
"F. Zysk (strata) z działalności operacyjnej (C+D-E)":"-74307.23",
"G. Przychody finansowe":"0.00",
"I. Dywidendy i udziały w zyskach w tym":"0.00",
"II. Odsetki w tym":"0.00",
"- od jednostek powiązanych":"0.00",
"III. Zysk ze zbycia inwestycji":"0.00",
"IV. Aktualizacja wartości inwestycji":"0.00",
"V. Inne":"0.00",
"H. Koszty finansowe":"27431.16",
"I. Odsetki w tym:":"26212.60",
"- dla jednostek powiązanych":"26212.60",
"II. Strata ze zbycia inwestycji":"0.00",
"III Aktualizacja wartości inwestycji":"0.00",
"IV. Inne":"1218.56",
"I. Zysk (strata) z działaności gospodarczej (F+G-H)":"-101738.39",
"L. Podatek dochodowy":"0.00",
"M. Pozostałe obowiązkowe zmniejszenia zysku (zwiększenia straty)":"0.00",
"N. Zysk (strata) netto (K-L-M)":"-101738.39"
}
},
"num_page":null,
"per_page":null,
"total_items":null,
"page_amounts":null,
"status":false
}
}
]
}
TD - Spr finansowe Skrócone JSON
Źródło umożliwia pobranie skróconych, ujednoliconych danych podstawowych ze sprawozdań finansowych w formacie JSON dla zadanego numeru NIP oraz wskazanych zakresów dat. Sprawozdania finansowe pochodzą z bazy dokumentów finansowych Ministerstwa Sprawiedliwości.
Przykładowe zapytanie
{
"source":"financial_ranges",
"method":"data",
"params":{
"nip":"123123123"
"dates-ranges": ["377200"],
"type": "slim"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1
{
"status":"done",
"ident":"a2e765a5-e3a9-4741-ba1f-c0672e35cc21",
"added":"2019-08-06 10:58:35",
"finished":"2019-08-06 10:58:54",
"user_account":null,
"progress":100,
"data":[
{
"task_id":6,
"source":"financial_ranges",
"method":"data",
"params":{
"nip":"1010005790",
"dates-ranges":[
"377200"
],
"type":"slim"
},
"meta":null,
"result":{
"nip":"1010005790",
"377200":{
"III. Należności długoterminowe":"0.00",
"I. Zapasy":"0.00",
"c. Środki pieniężne i inne aktywa pieniężne":"55847.40",
"Aktywa razem":"81261.69",
"A. Kapitał (fundusz) własny":"-373674.33",
"VII. Zysk (strata) z lat ubiegłych":"-321935.94",
"VIII. Zysk (strata) netto":"-101738.39",
"IV. Rozliczenia międzyokresowe":"164.00",
"Pasywa razem":"81261.69",
"I. Przychody netto ze sprzedaży produktów":"0.00",
"IV. Przychody netto ze sprzedaży towarów i materiałów":"0.00"
}
}
}
]
}
TD - CEIDG JSON
Źródło umożliwia pobranie wszystkich danych o podmiocie z rejestru CEIDG w formacie JSON.
Przykładowe zapytanie
{
"source":"ceidg",
"method":"data",
"params":{
"nip":"123123123"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1
Przykładowy zestaw danych wywołując metode /result
{
"status":"done",
"ident":"63eb039d-9039-4e6c-a1a2-924e348c18c1",
"added":"2018-12-07 09:59:39",
"finished":"2018-12-07 09:59:40",
"user_account":null,
"progress":100,
"data":[
{
"task_id":198,
"source":"ceidg",
"method":"data",
"params":{
"nip":"123123123"
},
"meta":null,
"result":{
"first_name":"ANNA MARIA",
"last_name":"KRZECZKOWSKA",
"nip":"123123123",
"regon":"123123123",
"company_name":"Wypożyczalnia samochodów AM KRZECZKOWSKA",
"company_status":"Aktywny",
"beginning_date":"2018-01-10",
"suspended_from_date":null,
"suspended_to_date":null,
"resumption_date":null,
"ending_date":null,
"deletion_legal_basis":null,
"legal_basis_details":null,
"cancellation":null,
"has_community_of_goods":"0",
"main_pkd":"9609Z",
"nationality":null,
"phone":"+48 100 001 001",
"fax":null,
"www":null,
"email":"am.krzeczkowska.wypozyczalnia@wp.pl",
"main_address":{
"street":"ul. Nowy Świat",
"number":"443",
"local":"42",
"commune":"Lutowiska",
"county":"ustrzycki",
"region":"PODKARPACKIE",
"post":"Lutowiska",
"postcode":"10-001",
"city":"Lutowiska"
},
"postal_address":{
"street":"ul. Nowy Świat",
"number":"443",
"local":"42",
"commune":"Lutowiska",
"county":"ustrzycki",
"region":"PODKARPACKIE",
"post":"Lutowiska",
"postcode":"10-001",
"city":null
},
"in_civil_partnership":"1",
"civil_partnership_details":[
{
"nip":"121212121",
"regon":"121212121",
"activity_suspended":null,
"partners_nip_numbers":[
"121212121",
"121212121"
]
},
{
"nip":"121212121",
"regon":null,
"activity_suspended":null,
"partners_nip_numbers":[
"121212121"
]
}
],
"permissions":[
],
"restrictions":[
{
"description":"Tak",
"period":"5 lat",
"institution":"Sąd Rejonowy w Lesku ",
"file_number":"VI Lsk 1/1",
"type":"Zakaz prowadzenia działalności gospodarczej",
"ruling_date":"2015-01-11",
"effective_date":"2015-02-02"
}
],
"agents":[
{
"name":"Erazm Kowalski",
"nip":null,
"permissions":"zmiana wpisu,wpis informacji o zawieszeniu wykonywania działalności gospodarczej,wpis informacji o wznowieniu wykonywania działalności gospodarczej,wniosek o wykreślenie wpisu w CEIDG,prowadzenie spraw za pośrednictwem punktu kontaktowego"
}
],
"extra_addresses":[
{
"street":"ul. Bolesława Krzywoustego",
"number":"26",
"local":"8",
"county":"Szczecin",
"region":"ZACHODNIOPOMORSKIE",
"post":"Szczecin",
"postcode":"70-316",
"city":"Szczecin"
}
]
}
}
]
}
TD - Wyciąg CEIDG PDF
Źródło umożliwia pobranie pełnych wyciągów z CEIDG w formie plików PDF.
Przykładowe zapytanie
{
"source":"ceidg",
"method":"pdf",
"params":{
"nip":"123123123"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1
W ramach odpowiedzi, użytkownik otrzyma zakodowany w Base64 plik z wyciągiem.
Przykładowy zestaw danych wywołując metode /result
{
"status":"done",
"ident":"63eb039d-9039-4e6c-a1a2-924e348c18c1",
"added":"2018-12-07 09:59:39",
"finished":"2018-12-07 09:59:40",
"user_account":null,
"progress":100,
"data":[
{
"task_id":171,
"source":"ceidg",
"method":"pdf",
"params":{
"nip":"123123123"
},
"meta":null,
"result":{
"file":"JVBERJGLCB....T0YK",
"added":"2018-11-09 14:56:19"
}
}
]
}
TD - Raport Oceny Ryzyka PDF
Źródło umożliwia pobranie przygotowanych przez Transparent Data Raportów Oceny Ryzyka w formie plików PDF. W raporcie znajdują się wyselekcjonowane dane zgodne z aktualnym stanem KRS, CEIDG, MSiG, GUS, PARP, UZP, KNF, UOKiK, URE, WHOIS, GIOŚ, RDN, CRBR, prywatnych giełd wierzytelności, stron internetowych firm i mediów internetowych.
Przykładowe zapytanie
{
"source":"raport_ryzyka",
"method":"pdf",
"params":{
"nip":"123123123"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator
curl --user:pass https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1
W ramach odpowiedzi, użytkownik otrzyma zakodowany w Base64 plik pdf z raportem.
Przykładowy zestaw danych wywołując metode /result
{
"status":"done",
"ident":"63eb039d-9039-4e6c-a1a2-924e348c18c1",
"added":"2018-12-07 09:59:39",
"finished":"2018-12-07 09:59:40",
"user_account":null,
"progress":100,
"data":[
{
"task_id":171,
"source":"raport_ryzyka",
"method":"pdf",
"params":{
"nip":"9721286534"
},
"meta":null,
"result":{
"file":"JVBERJGLCB....T0YK",
"added":"2018-11-09 14:56:19"
}
}
]
}
TD - Raport Oceny Ryzyka JSON
Źródło umożliwia pobranie wszystkich danych z przygotowanych przez Transparent Data Raportów Oceny Ryzyka w formacie JSON.
W raporcie znajdują się wyselekcjonowane dane zgodne z aktualnym stanem KRS, CEIDG, MSiG, GUS, PARP, UZP, KNF, UOKiK, URE, WHOIS, GIOŚ, RDN, CRBR, prywatnych giełd wierzytelności, stron internetowych firm i mediów internetowych.
Przykładowe zapytanie
{
"source":"raport_ryzyka",
"method":"data",
"params":{
"nip":"123123123"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "a58271f8-55ef-4564-ad55-f954cf7a1e0d"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator.
Przykładowy zestaw danych wywołując metode /result
{
"status": "done",
"ident": "a58271f8-55ef-4564-ad55-f954cf7a1e0d",
"user_account": null,
"progress": 100,
"data": [
{
"task_id": 6868,
"source": "raport_ryzyka",
"method": "data",
"params": {
"nip": "7740001454"
},
"meta": null,
"result": {
"basic_data": {
"young_company": {
"label_short": "Młoda firma",
"label_long": "Czy badany podmiot został zarejestrowany w przeciągu ostatnich 12 miesięcy?",
"value": "Nie"
},
"capital_paid": {
"label_short": "Wniesienie kapitału",
"label_long": "Czy został wniesiony kapitał zakładowy?",
"value": "Tak"
},
"capital_value": {
"label_short": "Kapitał zakładowy",
"label_long": "Wysokość kapitału zakładowego",
"value": "534636326.25"
},
"capital_lowered": {
"label_short": "Obniżenie kapitału",
"label_long": "Czy badany podmiot obniżył kapitał zakładowy? Jeżeli tak, ostatnia data",
"value": "Brak danych"
},
"company_status": {
"label_short": "Status podmiotu",
"label_long": "Aktualny status badanego podmiotu",
"value": "Aktywna"
},
"suspension": {
"label_short": "Zawieszenie działalności",
"label_long": "Czy badany podmiot zawiesił działalność w przeciągu ostatnich 12 miesięcy?",
"value": "Nie"
},
"scope_change": {
"label_short": "Zmiana przedmiotu działalności",
"label_long": "Czy badany podmiot zmienił przedmiot działalności w przeciągu ostatnich 12 miesięcy?",
"value": "Nie"
},
"sc_partner": {
"label_short": "Wspólnik spółki cywilnej",
"label_long": "Czy badany podmiot jest wspólnikiem w spółce cywilnej?",
"value": "Nie dotyczy"
}
},
"contact_data": {
"same_phone": {
"label_short": "Ten sam telefon",
"label_long": "Liczba podmiotów, które mają ten sam numer kontaktowy co badany podmiot",
"value": "0"
},
"same_email": {
"label_short": "Ten sam adres email",
"label_long": "Liczba podmiotów, które mają ten sam adres email co badany podmiot",
"value": "0"
},
"same_address": {
"label_short": "Liczba firm pod adresem",
"label_long": "Liczba podmiotów zarejestrowanych pod tym samym adresem co badany podmiot",
"value": "23"
},
"address_change": {
"label_short": "Zmiana adresu",
"label_long": "Data ostatniej zmiany adresu badanego podmiotu",
"value": "-"
},
"virtual_office": {
"label_short": "Biuro wirtualne",
"label_long": "Czy badany podmiot jest zarejestrowany pod adresem, pod którym działa również biuro wirtualne?",
"value": "Nie"
},
"www": {
"label_short": "Czy znamy stronę www podmiotu?",
"label_long": "Czy dla badanego podmiotu znamy adres strony internetowej?",
"value": "Tak"
}
},
"board_data": {
"board_changes": {
"label_short": "Zmiana w zarządzie",
"label_long": "Data ostatniej zmiany osobowej w zarządzie",
"value": "2018-08-14"
},
"board_age": {
"label_short": "Wiek zarządu",
"label_long": "Lata urodzenia członków zarządu",
"value": "1977, 1953, 1976, 1953, 1974, 1974, 1973, 1986"
},
"board_activity": {
"label_short": "Aktywność zarządu",
"label_long": "Liczba innych firm niż badany podmiot, w których zaangażowani są członkowie zarządu",
"value": "1, 0, 1, 3, 0, 0, 2, 3"
},
"board_control": {
"label_short": "Zarząd kontrola",
"label_long": "Czy członkowie zarządu mają co najmniej 50,01% udziałów",
"value": "Nie"
},
"board_history": {
"label_short": "Historia członków zarządu",
"label_long": "Czy członkowie zarządu uczestniczyli w upadłości/likwidacji innych podmiotów niż badany",
"value": "Nie"
},
"board_pep": {
"label_short": "Członek zarządu PEP",
"label_long": "Czy członkowie zarządu są PEP wg polskiej ustawy",
"value": "Nie, Nie, Nie, Nie, Nie, Nie, Nie, Nie"
},
"board_sanction_list": {
"label_short": "Członek zarządu listy sankcyjne",
"label_long": "Czy członkowie zarządu są na listach sankcyjnych",
"value": "Nie, Nie, Nie, Nie, Nie, Nie, Nie, Nie"
}
},
"owners_data": {
"owner_change": {
"label_short": "Zmiana właścicielska",
"label_long": "Data ostatniej zmiany składu właścicielskiego badanego podmiotu",
"value": "Brak informacji, spółka notowana na GPW"
},
"owner_age": {
"label_short": "Wiek właścicieli",
"label_long": "Lata urodzenia lub daty założenia udziałowców",
"value": "Brak informacji, spółka notowana na GPW"
},
"owner_single_person": {
"label_short": "Spółka jednoosobowa",
"label_long": "Czy członek zarządu i 100% udziałowiec to ta sama osoba",
"value": "Nie"
},
"owner_real_beneficiary": {
"label_short": "Beneficjent rzeczywisty",
"label_long": "Czy znany jest beneficjent rzeczywisty badanego podmiotu",
"value": "Nie"
},
"owner_related_subjects": {
"label_short": "Podmioty zależne",
"label_long": "Liczba podmiotów, w których badany podmiot jest udziałowcem",
"value": "23"
},
"owner_pep": {
"label_short": "Właściciel PEP",
"label_long": "Czy właściciele są PEP wg polskiej ustawy",
"value": "Brak informacji, spółka notowana na GPW"
},
"owner_saction_list": {
"label_short": "Właściciel listy sankcyjne",
"label_long": "Czy udziałowcy są na listach sankcyjnych",
"value": "Brak informacji, spółka notowana na GPW"
}
},
"financial_data": {
"report_obligation": {
"label_short": "Obowiązek składania sprawozdania finansowego",
"label_long": "Czy dany podmiot ma obowiązek składania sprawozdania finansowego w KRS",
"value": "Tak"
},
"latest_report": {
"label_short": "Ostatnie złożone sprawozdanie",
"label_long": "Rok złożenia ostatniego sprawozdania finansowego w KRS",
"value": "2017"
},
"latest_available_report": {
"label_short": "Ostatnie dostępne sprawozdanie",
"label_long": "Rok złożenia sprawozdania dostępnego w bazie Transparent Data",
"value": 2017
},
"financial_reports": {
"label_short": "Składanie sprawozdań",
"label_long": "Lata, w których badany podmiot złożył sprawozdanie finansowe",
"value": "2017, 2016, 2015, 2014, 2013, 2012, 2011, 2010, 2009, 2008, 2007, 2006, 2005, 2004, 2003, 2002, 2001, 1970"
},
"bankruptcy_probability": {
"label_short": "Prawdopodobieństwo upadłości w ciągu następnych 12 miesięcy",
"label_long": "Obliczane na podstawie ostatniego złożonego w KRS sprawozdania finansowego",
"value": "Bardzo niskie"
},
"aktywa": {
"label_short": "Aktywa",
"label_long": "Wysokość aktywów w ostatnim dostępnym sprawozdaniu",
"value": "49352000000.00"
},
"pasywa": {
"label_short": "Pasywa",
"label_long": "Wysokość pasywów w ostatnim dostępnym sprawozdaniu",
"value": "49352000000.00"
},
"zapasy": {
"label_short": "Zapasy",
"label_long": "Wysokość zapasów w ostatnim dostępnym sprawozdaniu",
"value": "8239000000.00"
},
"rozliczenia_miedzyokresowe": {
"label_short": "Rozliczenia międzyokresowe",
"label_long": "Wysokość rozliczeń międzyokresowych w ostatnim dostępnym sprawozdaniu",
"value": "0.00"
},
"srodki_pieniezne": {
"label_short": "Środki pieniężne",
"label_long": "Wysokość środków pieniężnych w ostatnim dostępnym sprawozdaniu",
"value": "5477000000.00"
},
"krotkoterminowe": {
"label_short": "Należności krótkoterminowe",
"label_long": "Wysokość należności krótkoterminowych w ostatnim dostępnym sprawozdaniu",
"value": "7393000000.00"
},
"dlugoterminowe": {
"label_short": "Należności długoterminowe",
"label_long": "Wysokość należności długoterminowych w ostatnim dostępnym sprawozdaniu",
"value": "0.00"
},
"zysk_strata": {
"label_short": "Zysk/strata",
"label_long": "Wysokość zysku/straty w ostatnim dostępnym sprawozdaniu",
"value": "6102000000.00"
},
"zysk_strata_poprzedni_rok": {
"label_short": "Zysk/strata w poprzednim roku",
"label_long": "Wysokość zysku/straty w przedostatnim dostępnym sprawozdaniu",
"value": "5364000000.00"
},
"kapital_wlasny": {
"label_short": "Kapitał własny",
"label_long": "Wysokość kapitału własnego badanego podmiotu",
"value": "27565000000.00"
},
"przychody_ze_sprzedazy": {
"label_short": "Przychody ze sprzedaży",
"label_long": "Wysokość przychodów ze sprzedaży w ostatnim dostępnym sprawozdaniu",
"value": "70012000000.00"
}
},
"debts_data": {
"private_debts": {
"label_short": "Giełdy wierzytelności",
"label_long": "Czy badany podmiot jest aktualnie na publicznych giełdach wierzytelności?",
"value": "Nie"
},
"private_debts_amount": {
"label_short": "Suma wierzytelności",
"label_long": "Suma zadłużenia badanego podmiotu na publicznych giełdach wierzytelności",
"value": "0.00"
},
"rdn": {
"label_short": "RDN",
"label_long": "Czy badany podmiot jest w Rejestrze Dłużników Niewypłacalnych?",
"value": "Nie"
},
"krs_debts": {
"label_short": "4 dział KRS",
"label_long": "Czy badany podmiot ma zaległości wpisane w 4 dziale KRS",
"value": "Nie"
}
},
"other_data": {
"pl_vat_payer": {
"label_short": "Aktywny VAT PL",
"label_long": "Czy badany podmiot jest jest aktywnym płatnikiem VAT?",
"value": "Tak"
},
"eu_vat_payer": {
"label_short": "Aktywny VAT EU",
"label_long": "Czy badany podmiot jest jest aktywnym płatnikiem VAT?",
"value": "Tak"
},
"knf": {
"label_short": "Lista ostrzeżeń KNF",
"label_long": "Czy badany podmiot jest na liście ostrzeżeń KNF?",
"value": "Nie"
},
"uokik": {
"label_short": "Decyzje UOKiK",
"label_long": "Czy badany podmiot był przedmiotem decyzji UOKiK?",
"value": "Tak"
},
"eu_grants": {
"label_short": "Dotacje unijne",
"label_long": "Czy badany podmiot pozyskał dotacje unijne?",
"value": "Tak"
}
}
}
}
]
}
TD - Raport Prześwietl PDF
Źródło umożliwia pobranie raportów handlowych z platformy Prześwietl.pl w formie plików PDF.
W raporcie znajdują się kompleksowe, zintegrowane przez Transparent Data dane zgodne z aktualnym stanem KRS, CEIDG, MSiG, GUS, PARP, UZP, KNF, UOKiK, URE, WHOIS, GIOŚ, RDN, CRBR, Wykazu Podatników VAT, prywatnych giełd wierzytelności, stron internetowych firm i mediów internetowych.
Przykładowe zapytanie
{
"source":"raport_przeswietl",
"method":"pdf",
"params":{
"nip":"123123123"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1
W ramach odpowiedzi, użytkownik otrzyma zakodowany w Base64 plik pdf z raportem.
Przykładowy zestaw danych wywołując metode /result
{
"status":"done",
"ident":"63eb039d-9039-4e6c-a1a2-924e348c18c1",
"added":"2018-12-07 09:59:39",
"finished":"2018-12-07 09:59:40",
"user_account":null,
"progress":100,
"data":[
{
"task_id":171,
"source":"raport_przeswietl",
"method":"pdf",
"params":{
"nip":"9721286534"
},
"meta":null,
"result":{
"file":"JVBERJGLCB....T0YK",
"added":"2018-11-09 14:56:19"
}
}
]
}
TD - Raport Prześwietl JSON
Źródło umożliwia pobranie wszystkich danych z raportów handlowych z platformy Prześwietl.pl w formacie JSON.
W raporcie znajdują się kompleksowe, zintegrowane przez Transparent Data dane zgodne z aktualnym stanem KRS, CEIDG, MSiG, GUS, PARP, UZP, KNF, UOKiK, URE, WHOIS, GIOŚ, RDN, CRBR, Wykazu Podatników VAT, prywatnych giełd wierzytelności, stron internetowych firm i mediów internetowych.
Przykładowe zapytanie
{
"source":"raport_przeswietl",
"method":"data",
"params":{
"nip":"123123123"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1
Przykładowy zestaw danych wywołując metode /result
{
"status": "done",
"ident": "d934b5df-34f4-41f8-b350-ecc93c0b1b78",
"user_account": null,
"progress": 100,
"data": [
{
"task_id": 6875,
"source": "raport_przeswietl",
"method": "data",
"params": {
"nip": "7740001454"
},
"meta": null,
"result": {
"knf": [
{
"last_checked": "2018-12-11 15:48:02",
"prosecutor": "Prokuratura Rejonowa Kraków-Podgórze ",
"company_name": "Nazwa firmy",
"identification_number": "123123123",
"identification_type": "nip"
}
],
"public_debt": [
{
"source": "zrodlo_pozyskania",
"last_update": "2018-12-11 15:43:23",
"company_name": "Nazwa firmy sp. zoo",
"nip": "123123123",
"external_ident": "8250002694_350.56",
"debt_amount": "2350.16"
}
],
"financial": {
"data": {
"2015": {
"01.01": "23146000000.00",
"01.01.01": "962000000.00",
"01.01.01.01": "0.00",
"..."
},
"2016": {
"01.01": "25109000000.00",
"01.01.01": "853000000.00",
"01.01.01.01": "0.00",
"..."
},
"2017": {
"01.01": "26407000000.00",
"01.01.01": "772000000.00",
"01.01.01.01": "0.00",
"..."
}
},
"labels": {
"01.01": "A. Aktywa trwałe",
"01.01.01": "I. Wartości niematerialne i prawne",
"01.01.01.01": "1. Koszty zakończonych prac rozwojowych",
"..."
}
},
"beneficiary": [
{
"percent": 76.8,
"name2": "IMIE1 NAZWISKO1"
},
{
"percent": 20,
"name2": "IMIE2 NAZWISKO2"
},
{
"percent": 2,
"name2": "IMIE3 NAZWISKO3"
}
],
"ure": [
{
"company_name": "Nazwa firmy S.A.",
"valid_from": "2013-11-22",
"valid_to": "2030-12-31",
"short_code": "PPC",
"description": "przesył paliw ciekłych"
},
{
"company_name": "Nazwa firmy S.A.",
"valid_from": "1998-11-28",
"valid_to": "2025-12-31",
"short_code": "WPC",
"description": "wytwarzanie paliw ciekłych"
}
]
}
}
]
}
TD - Raport Należytej Staranności PDF
Źródło umożliwia pobranie przygotowanych przez Transparent Data Raportów Należytej Staranności w formie plików PDF.
W raporcie znajdują się wyselekcjonowane dane zgodne z aktualnym stanem KRS, CEIDG, GUS, PARP, URE, WHOIS, Wykazu Podatników VAT, stron internetowych firm i mediów internetowych.
Przykładowe zapytanie
{
"source":"due_diligence_pl",
"method":"pdf",
"params":{
"nip":"123123123"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "a2b2t3y2-1y3p-uei5-ear2-tj2re3468661"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=a2b2t3y2-1y3p-uei5-ear2-tj2re3468661
W ramach odpowiedzi, użytkownik otrzyma zakodowany w Base64 plik pdf z raportem.
Przykładowy zestaw danych zwracanych z metody /result
{
"status":"done",
"ident":"a2b2t3y2-1y3p-uei5-ear2-tj2re3468661",
"added":"2018-12-07 09:59:39",
"finished":"2018-12-07 09:59:40",
"user_account":null,
"progress":100,
"data":[
{
"task_id":166,
"source":"due_diligence_pl",
"method":"pdf",
"params":{
"nip":"123123123"
},
"meta":null,
"result":{
"file":"JVBERJGLCB....IIOS",
"added":"2018-11-09 14:56:19"
}
}
]
}
Raport EHSS PDF
Źródło umożliwia pobranie raportów Euler Hermes Smart Sales w formie plików PDF.
Przykładowe zapytanie
{
"source":"euler_hermes_smart_sales",
"method":"pdf",
"params":{
"nip":"123123123"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "12e20392-113p-ee65-1a22-gg24e3498cc1"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=12e20392-113p-ee65-1a22-gg24e3498cc1
W ramach odpowiedzi, użytkownik otrzyma zakodowany w Base64 plik pdf z raportem
Przykładowy zestaw danych zwracanych z metody /result
{
"status":"done",
"ident":"12e20392-113p-ee65-1a22-gg24e3498cc1",
"added":"2018-12-07 09:59:39",
"finished":"2018-12-07 09:59:40",
"user_account":null,
"progress":100,
"data":[
{
"task_id":166,
"source":"euler_hermes_smart_sales",
"method":"pdf",
"params":{
"nip":"123123123"
},
"meta":null,
"result":{
"file":"JVBERJGLCB....UPSZ",
"added":"2018-11-09 14:56:19"
}
}
]
}
TD - Upadłości konsumenckie JSON
Źródło umożliwia pobranie danych z bazy upadłości konsumenckich Monitora Sądowego i Gospodarczego (MSiG) w formacie JSON.
Przykładowe zapytanie
{
"source":"upadlosci_konsumenckie",
"method":"search",
"params":{
"pesel":"123123123"
}
}
W polu params można wykorzystać różne typy parametrów:
| Nazwa | Opis |
|---|---|
pesel |
Szukanie po numerze PESEL |
krs |
Szukanie po numerze KRS |
txt |
Szukanie w pełnej treści odpisu |
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1
Przykładowy zestaw danych wywołując metode /result
{
"status": "done",
"ident": "da252a6d-d723-4704-bb10-f2ab40de4a16",
"user_account": null,
"progress": 100,
"data": [
{
"task_id": 6967,
"source": "upadlosci_konsumenckie",
"method": "search",
"params": {
"txt": "nowak"
},
"meta": null,
"result": [
{
"ident": "BMSiG-933/2016",
"name": "Imie Nazwisko",
"krs": null,
"pesel": "123123123",
"txt": "Pełna treść wpisu"
},
{
"ident": "BMSiG-5319/2016",
"name": "Imię Nazwisko",
"krs": null,
"pesel": "123123123",
"txt": "Pełna treść wpisu"
},
TD - Listy sankcyjne JSON
Źródło umożliwia pobranie informacji o obecności danej osoby fizycznej na 16 największych światowych listach sankcji w formacie JSON.
| Kraj | Nazwa |
|---|---|
| USA | OFAC Specially Designated Nationals (SDN) List (U.S. Treasury) |
| USA | OFAC Foreign Sanctions Evaders (FSE) List (U.S. Treasury) |
| USA | Sectoral Sanctions Identifications (SSI) List |
| USA | Palestinian Legislative Council (NS-PLC) list |
| USA | The List of Foreign Financial Institutions Subject to Part 561 (the Part 561 List) |
| USA | Non-SDN Iranian Sanctions Act (NS-ISA) List |
| USA | List of Persons Identified as Blocked Solely Pursuant to Executive Order 13599 (the 13599 List) |
| EU | Common Foreign and Security Policy (CFSP) of the European Union (Sanctions EU) |
| UK | HR Treasury (HMT) Financial sanctions: Consolidated List of Targets (UK) |
| UK | Current LIst of designated persons, terrorism and terrorist financing |
| UK | UK Insolvency Disqualified Directors |
| UN | Consolidated United Nations Security Council Sanctions List (UN Sanctions List) |
| CAN | Office of the Superintendent of Financial Institutions Anti-terrorism Financing List |
| AUS | The Consolidated List |
| BL | Consolidated List of the National Belgian List and of the List of European Sanctions |
| FR | Liste Unique de Gels de la Direction générale du Trésor |
Przykładowe zapytanie
{
"source":"aml_sanction",
"method":"check",
"params":{
"name":"Jan Kowalski"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1
Przykładowy zestaw danych wywołując metode /result
"Jan Kowalski","Sprawdzono: brak wyników","Sprawdzono: brak wyników"
TD - Beneficjent rzeczywisty PL JSON
Źródło umożliwia pobranie danych o beneficjencie rzeczywistym firm z Polski w formacie JSON. Informacje (imię i nazwisko, numer PESEL beneficjenta rzeczywistego wraz ze wskazaniem procentu udziałów) pochodzą z powiązanych rejestrów KRS i CEIDG oraz Centralnego Rejestru Beneficjentów Rzeczywistych.
Przykładowe zapytanie
{
"source":"beneficiary",
"method":"getPl",
"params":{
"nip":"123123123"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1
Przykładowy zestaw danych wywołując metode /result
{
"status":"done",
"ident":"63eb039d-9039-4e6c-a1a2-924e348c18c1",
"added":"2018-12-07 09:59:39",
"finished":"2018-12-07 09:59:40",
"user_account":null,
"progress":100,
"data": [
{
"task_id": 198,
"source": "beneficiary",
"method": "getPl",
"params": {
"nip": "123123123"
},
"meta": null,
"result": {
"beneficiaries": [
{
"pesel": "xxxxxxxxxxxxx",
"percentage": 66.67,
"name": "BOGDAN TRZMIEL"
},
{
"pesel": "xxxxxxxxxxxxx",
"percentage": 33.33,
"name": "KALINA NOWAK"
}
]
}
}
]
}
TD - PEP JSON
Źródło umożliwia pobranie informacji o obecności danej osoby fizycznej w 9 bazach osób eksponowanych politycznie (PEP) w formacie JSON.
Dane (imię i nazwisko, stanowisko, data urodzenia, kadencja) zwracane są na podstawie następujących baz PEP:
- Baza własna PEP Polska Transparent Data,
- CoE Parliamentary Assembly
- Members Of EU Parliament
- Every Politician
- LittleSis
- Rulers
- World Presidents Source
- Bank Of Uruguay
- CIA Factbook World Leaders Chiefs of State and Cabinet Members of Foreign Governments
Przykładowe zapytanie
{
"source":"pep",
"method":"check",
"params":{
"name":"Andrzej Duda"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "fcb5ee35-5172-42d1-916b-c5fa442fabee"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=fcb5ee35-5172-42d1-916b-c5fa442fabee
Przykładowy zestaw danych wywołując metode /result
Przykładowa odpowiedź
{
"status": "done",
"ident": "fcb5ee35-5172-42d1-916b-c5fa442fabee",
"user_account": null,
"progress": 100,
"data": [
{
"task_id": 14199,
"source": "pep",
"method": "check",
"params": {
"name": "Andrzej Duda"
},
"meta": null,
"result": {
"list_name": "Znaleziono: PepTDataSource",
"list_details": "Prezydent RP"
}
}
]
}
TD - REGON JSON
Źródło umożliwia pobranie danych o podmiocie z rejestru REGON Głównego Urzędu Statystycznego w formacie JSON.
Przykładowe zapytanie
{
"source":"regon",
"method":"data",
"params":{
"nip":"123123123"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator.
curl --user:pass https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1
Przykładowy zestaw danych wywołując metode /result
{
"status": "done",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1",
"user_account": null,
"progress": 100,
"data": [
{
"task_id": 18288,
"source": "regon",
"method": "data",
"params": {
"nip": "6920000013"
},
"meta": null,
"result": {
"last_update": "2019-05-22 16:14:32",
"regon": "390021764",
"nip": "6920000013",
"podstawowa_forma_prawna": "1",
"szczegolna_forma_prawna": "116",
"forma_wlasnosci": "235",
"nazwa": "KGHM POLSKA MIEDŹ SPÓŁKA AKCYJNA",
"imie": null,
"nazwisko": null,
"company_status": "aktywna",
"data_wpisu": null,
"data_wpisu_do_rejestru_ewidencji": "2001-06-29",
"data_skreslenia_z_rejestru_ewidencji": null,
"data_zakoczenia_postepowania_upadlosciowego": null,
"data_powstania": "1991-09-13",
"data_rozpoczecia_dzialanosci": "1991-09-13",
"data_zawieszenia": null,
"data_wznowienia": null,
"data_zakonczenia": null,
"data_wykreslenia": null,
"data_orzeczenia_upadlosci": null,
"kraj": "PL",
"wojewodztwo_kod": "02",
"powiat_kod": "11",
"gmina_kod": "011",
"kod_pocztowy": "59-301",
"teryt_poczta": "0954142",
"teryt_miejscowosc": "0954142",
"teryt_ulica": "20068",
"ulica": "ul. Marii Skłodowskiej-Curie",
"nr_budynku": "48",
"nr_lokalu": null,
"miejscowosc": "Lubin",
"nietypowe_miejsce_lokalizacji": null,
"poczta": "Lubin",
"gmina": "Lubin",
"powiat": "lubiński",
"wojewodztwo": "DOLNOŚLĄSKIE",
"nazwa_kraju": "POLSKA",
"organ_rejestrowy": "SĄD REJONOWY DLA WROCŁAWIA FABRYCZNEJ WE WROCŁAWIU, IX WYDZIAŁ GOSPODARCZY KRAJOWEGO REJESTRU SĄDOWEGO",
"rodzaj_rejestru": "REJESTR PRZEDSIĘBIORCÓW",
"numer_rejestrowy": "0000023302",
"jednostek_lokalowych": "11",
"dzialanosci": "0",
"wspolnicy": "0",
"pkd_glowne": "0729Z",
"pkd_pozostale": "3514Z,3513Z,3511Z,2454A,2445Z,2444Z,2443Z,2441Z,0893Z",
"telefon": null,
"telefon_wew": null,
"fax": null,
"email": null,
"www": null
}
}
]
}
TD - Raport Biała Lista PDF
Źródło umożliwia pobranie przygotowanych przez Transparent Data Raportów Biała Lista w formie plików PDF. W raporcie znajdują się informacje zgodne z Wykazem Podatników VAT (tzw. Biała Lista), prowadzonym przez Ministerstwo Finansów, poszerzone o informacje dotyczące właściwości Urzędu Skarbowego oraz identyfikacji banków, w jakich założone są firmowe rachunki bankowe.
Przykładowe zapytanie
{
"source":"white_list",
"method":"pdf",
"params":{
"nip":"123123123"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator.
W ramach odpowiedzi, użytkownik otrzyma zakodowany w Base64 plik pdf z raportem.
Przykładowy zestaw danych wywołując metode /result
{
"status":"done",
"ident":"63eb039d-9039-4e6c-a1a2-924e348c18c1",
"added":"2018-12-07 09:59:39",
"finished":"2018-12-07 09:59:40",
"user_account":null,
"progress":100,
"data":[
{
"task_id":171,
"source":"white_list",
"method":"pdf",
"params":{
"nip":"123123123"
},
"meta":null,
"result":{
"pdf":"JVBERJGLCB....T0YK",
"date":"2018-11-09 14:56:19"
}
}
]
}
TD - Raport Biała Lista JSON
Źródło umożliwia pobranie wszystkich danych z przygotowanych przez Transparent Data Raportów Biała Lista w formacie JSON. W zestawie danych znajdują się informacje zgodne z Wykazem Podatników VAT (tzw. Biała Lista), prowadzonym przez Ministerstwo Finansów, poszerzone o informacje dotyczące właściwości Urzędu Skarbowego oraz identyfikacji banków, w jakich założone są firmowe rachunki bankowe.
Przykładowe zapytanie
{
"source":"white_list",
"method":"getWhiteList",
"params":{
"nip":"7740001454"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "5dd5a93b-9995-4e3a-b06a-71f10840db69"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator.
Przykładowy zestaw danych wywołując metode /result
{
"status": "done",
"ident": "5dd5a93b-9995-4e3a-b06a-71f10840db69",
"added": "2019-12-16 10:36:07",
"finished": "2019-12-16 10:36:58",
"user_account": "sample@com.pl",
"progress": 100,
"data": [
{
"task_id": 21,
"source": "white_list",
"method": "getWhiteList",
"params": {
"nip": "7740001454",
"date": "2019-12-10"
},
"meta": {
"type": "file",
"query": "",
"source": ""
},
"result": {
"id": "1001",
"date_status": "2019-12-10",
"nip": "7740001454",
"regon": "610188201",
"krs": "0000028860",
"pesel": null,
"name": "POLSKI KONCERN NAFTOWY ORLEN SPÓŁKA AKCYJNA",
"request_id": "5ljel-85m3j39",
"vat_status": "Czynny",
"working_address": "CHEMIKÓW 7, 09-411 PŁOCK",
"residence_address": null,
"postcode": "09-411",
"registration_legal_date": "2003-12-31",
"registration_denial_date": null,
"registration_denial_basis": null,
"removal_date": null,
"removal_basis": null,
"restoration_date": null,
"restoration_basis": null,
"virtual_account": "1",
"accounts": {
"Bank Polska Kasa Opieki Spółka Akcyjna": [
"80124054971978000050118306",
"70124011121111001070879914",
"37124031741111000028899332",
"67124052821111000048958743",
"46124031741787001047464116",
"55124031741111001059524978",
"49124052821111000048943547",
"38124052821111001080047440",
"87124031741787000028899358",
"89124031741111001032180939",
"82124052821111000048909585",
"81124042271978000048409900",
"97124062921111001083537159",
"06124052821111000048951887",
"04124052821111000048936015",
"29124062921213001086584127",
"18124031741111000032366066",
"56124042271111000048400835",
"78124052821111000048895107",
"74124054971111000050139066"
],
"mBank Spółka Akcyjna": [
"67114010100000243195001004",
"51114010100000243195001001",
"84114010100000243195001086",
"14114010100000243195001085",
"31114010100000243195001070",
"02114010100000243195001010",
"94114010100000243195001003"
],
"Powszechna Kasa Oszczędności Bank Polski Spółka Akcyjna": [
"03102010260000160202932796",
"53102039740000510200022384",
"60102010260000170202936862",
"35102010260000120203550597",
"48102010260000160202932762",
"53102010260000140202932770",
"40102010260000170203616901",
"55102010260000150202932200",
"14102010260000120202627438",
"97102010260000190202932218",
"58102010260000170203368354",
"30102010260000140203550589",
"85102010260000100203550571",
"19102010260000100202627446",
"59102010260000130202736965"
],
"Bank BGŻ BNP Paribas Spółka Akcyjna": [
"17160011271843983820000030",
"70160011271843983820000046",
"76160011271843983820000035",
"06160011271843983820000034",
"87160011271843983820000031",
"33160011271843983820000033",
"79160011271843983820000078",
"60160011271843983820000032"
],
"ING Bank Śląski Spółka Akcyjna": [
"15105000861000009030137625",
"08105000861000002258724406",
"90105000861000002310281825",
"09105000861000002441871155",
"39105000861000009031675904",
"28105000861000002310281486"
],
"Bank Handlowy w Warszawie Spółka Akcyjna": [
"57103015080000000500101652",
"47103013350000000500101500",
"54103015080000000500101415",
"04103015080000000500101636",
"02103015080000000500101963",
"26103015080000000500101628",
"82103015080000000500101202",
"70103015080000000500101903",
"85103015080000000500101148",
"19103015080000000500101075",
"63103015080000000500101253",
"60103015080000000500101113",
"76103015080000000500101504",
"82103015080000000500101008",
"13103015080000000500101474",
"10103015080000000500101237",
"73103015080000000500101946",
"98103015080000000500101011",
"79103015080000000500101644",
"66103015080000000500101199",
"79103015080000000500101547",
"29103015080000000500101962",
"38103015080000000500101121",
"16103015080000000500101032",
"38103015080000000500101024",
"88103015080000000500101482",
"95103015080000000500101938",
"35103015080000000500101563",
"04103015080000000500101539",
"51103015080000000500101954",
"28103015080000000500101010"
],
"Bank Gospodarstwa Krajowego": [
"54113000070003901111600001",
"47113000070003901111200002",
"74113000070003901111200001",
"20113000070003901111200003"
],
"Alior Bank Spółka Akcyjna": [
"52249000050000460029212301",
"19249000050000460027186856",
"31249000050000461294270480",
"75249000050000453063872359",
"56249000050000460037967449",
"98249000050000460077212408",
"70249000050000460092801879"
],
"Société Générale Spółka Akcyjna Oddział w Polsce": [
"54184000072211106008101019",
"68184000072211106008131322",
"19184000072211106008190210",
"37184000072211106008130522",
"76184000072211106007001419"
],
"Bank BPH Spółka Akcyjna": [
"90106000760000321000157452",
"25106000760000321000149213"
]
},
"relations": {
"representatives": [],
"authorized_clerks": [],
"partners": []
},
"revenue_agency": {
"name": "Urząd Skarbowy w Płocku",
"adress": "ul. 1 Maja 10, 09-402 Płock",
"email": "us.plock@mf.gov.pl",
"phone": "24 361-65-00",
"fax": "24 361-65-45"
}
}
}
]
}
TD - Biała Lista Weryfikacja NIP/Konto
Źródło umożliwia odpytanie czy podany numer NIP i konto bankowe widnieją na Białej Liście Ministerstwa Finansów we wskazanym dniu.
W ramach odpowiedzi, użytkownik otrzyma informację zwrotną czy podany nip posiada konto bankowe (TAK/NIE), status działalności gospodarczej oraz unikalny identyfikator zapytania.
Przykładowe zapytanie
{
"source": "white_list_tab",
"method": "csv",
"params": {
"nip": "1010000516",
"bankaccount": "84188000090000001101689000",
"date": "2020-01-12"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "fc5b7dd8-cd85-469f-9ecb-f84815ec6808"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator
Przykładowy zestaw danych wywołując metode /result
{
"status": "done",
"ident": "fc5b7dd8-cd85-469f-9ecb-f84815ec6808",
"added": "2019-10-07 12:53:29",
"finished": "2019-10-07 12:53:30",
"user_account": "sample@tsample.pl",
"progress": 100,
"data": [
{
"task_id": 79,
"source": "white_list_tab",
"method": "csv",
"params": {
"nip": "6262743001",
"bankaccount": "88105012301000009266593384",
"date": "2020-01-12"
},
"meta": {
"type": "file",
"query": "",
"source": ""
},
"result": {
"nip": "6262743001",
"date": "2020-01-12",
"status": "Czynny",
"bankcorrect": "Tak",
"request_id": "7601h-85k00gn"
}
}
]
}
TD - Biała Lista Przynależność NIP
Źródło umożliwia odpytanie o wszystkie konta bankowe dla podanego numeru NIP we wskazanym dniu. Dane są zgodne ze stanem Białej Listy Ministerstwa Finansów.
W ramach odpowiedzi użytkownik otrzyma listę kont bankowych przynależnych od podanego numeru nip, status działalności gospodarczej oraz unikalny identyfikator zapytania/
Przykładowe zapytanie
{
"source": "white_list_tab",
"method": "getAccountNumbers",
"params": {
"nip": "6262743001",
"date": "2019-12-01"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "857335c2-de4a-42f1-80bd-85987dc1b18f"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator,
Przykładowy zestaw danych wywołując metode /result
{
"status": "done",
"ident": "857335c2-de4a-42f1-80bd-85987dc1b18f",
"added": "2019-10-07 13:02:19",
"finished": "2019-10-07 13:02:49",
"user_account": "sample@sample.pl",
"progress": 100,
"data": [
{
"task_id": 80,
"source": "white_list_tab",
"method": "getAccountNumbers",
"params": {
"nip": "6262743001",
"date": "2019-12-01"
},
"meta": {
"type": "file",
"query": "",
"source": ""
},
"result": {
"nip": "6262743001",
"date": "2019-12-01",
"status":"Czynny",
"bankaccounts":"57188000090000001101689001,84188000090000001101689000",
"request_id":"lm4fm-85nhamb"
}
}
]
}
TD - Biała Lista Przynależność rachunku
Źródło umożliwia odpytanie o prawidłowy numer NIP dla podanego rachunku bankowego we wskazanym dniu. Dane są zgodne ze stanem Białej Listy Ministerstwa Finansów.
W ramach odpowiedzi, użytkownik otrzymuje numer nip przynależny do numeru rachunku bankowego, status działalności gospodarczej, oraz unikalny identyfikator zapytania.
Przykładowe zapytanie
{
"source": "white_list_tab",
"method": "getNipByAccountNumber",
"params": {
"bankaccount": "50175010640000000020066911",
"date": "2019-12-01"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "4c724bf0-f8d2-4c78-b1b2-5ce1e8cc4ea9"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator,
Przykładowy zestaw danych wywołując metode /result
{
"status": "done",
"ident": "4c724bf0-f8d2-4c78-b1b2-5ce1e8cc4ea9",
"added": "2019-10-07 13:04:46",
"finished": "2019-10-07 13:04:48",
"user_account": "sample@sample.pl",
"progress": 100,
"data": [
{
"task_id": 81,
"source": "white_list_tab",
"method": "getNipByAccountNumber",
"params": {
"bankaccount": "50175010640000000020066911",
"date": "2019-12-01"
},
"meta": {
"type": "file",
"query": "",
"source": ""
},
"result": {
"nip": "1010000019",
"status" : "Czynny",
"date": "2019-12-01",
"bankaccounts": "50175010640000000020066911",
"request_id":"ke5dm-86bggd0"
}
}
]
}
TD - Biała Lista Właściwy US
Źródło umożliwia pobranie danych o właściwości Urzędu Skarbowego dla wskazanego numeru NIP.
Przykładowe zapytanie
{
"source": "white_list_tab",
"method": "getRevenueAgency",
"params": {
"nip": "1010000516"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "fc5b7dd8-cd85-469f-9ecb-f84815ec6808"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator.
Przykładowy zestaw danych wywołując metode /result
{
"status": "done",
"ident": "fc5b7dd8-cd85-469f-9ecb-f84815ec6808",
"added": "2019-10-07 12:53:29",
"finished": "2019-10-07 12:53:30",
"user_account": "sample@tsample.pl",
"progress": 100,
"data": [
{
"task_id": 79,
"source": "white_list_tab",
"method": "getRevenueAgency",
"params": {
"nip": "1010000516"
},
"meta": {
"type": "file",
"query": "",
"source": ""
},
"result": {
"nip": "1010000516",
"name": "Urząd Skarbowy w Bystrzycy Kłodzkiej",
"adress": "ul. Mickiewicza 5 57-500 Bystrzyca Kłodzka",
"email": "us.bystrzyca_klodzka@mf.gov.pl",
"phone": "74 811-79-50",
"fax": "74 811-11-27"
}
}
]
}
Mastercard Match
Źródło umożliwia pobranie danych o podmiocie z systemu Mastercard Match.
Wszystkie dostępne parametry wywołania. Parametry, które nie zostały wypełnione nie są obligatoryjne.
{
"method":"data",
"source":"mastercard_match",
"params":{
"acquirerId":"1996",
"transactionReferenceNumber":"",
"merchant":{
"name":"TERMINATED MERCHANT 2",
"doingBussinessAsName":"",
"address":{
"line1":"20 EAST MAIN ST",
"line2":"",
"city":"EAST ISLIP NY",
"countrySubdivision":"",
"province":"",
"postalCode":"55555",
"country":"USA"
},
"phoneNumber":"",
"altPhoneNumber":"",
"nationalTaxId":"",
"countrySubdivisionTaxId":"",
"serviceProvLegal":"",
"serviceProvDBA":"",
"url":"",
"principals":[
{
"firstName":"ORLANDO",
"middleInitial":"",
"lastName":"BECKMAN",
"address":{
"line1":"73-52 243 STREET",
"line2":"",
"city":"ST LOUIS",
"countrySubdivision":"",
"province":"",
"postalCode":"55555",
"country":"USA"
},
"phoneNumber":"",
"altPhoneNumber":"",
"nationalId":"",
"driversLicense":{
"number":"",
"countrySubdivision":"",
"country":""
}
}
],
"urlGroups":[
{
"exactMatchUrls":[
""
],
"closeMatchUrls":[
""
],
"noMatchUrls":[
""
]
}
]
}
}
}
Przykładowe zapytanie
{
"method":"data",
"source":"mastercard_match",
"params":{
"acquirerId":"1996",
"merchant":{
"name":"TERMINATED MERCHANT 2",
"address":{
"line1":"20 EAST MAIN ST",
"city":"EAST ISLIP NY",
"postalCode":"55555",
"country":"USA"
},
"principals":[
{
"firstName":"ORLANDO",
"lastName":"BECKMAN",
"address":{
"line1":"73-52 243 STREET",
"city":"ST LOUIS",
"postalCode":"55555",
"country":"USA"
}
}
]
}
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
W celu pobrania danych, należy wykorzystać zwrócony identyfikator.
W ramach odpowiedzi, użytkownik otrzyma zakodowany w Base64 plik.
Przykładowy zestaw danych wywołując metode /result
{
"status":"done",
"ident":"7fb55bb9-d9c4-4ffd-859f-8cc37c3e3210",
"user_account":null,
"progress":100,
"data":[
{
"task_id":74134,
"source":"mastercard_match",
"method":"data",
"params":{
"acquirerId":"1996",
"merchant":{
"name":"TERMINATED MERCHANT 2",
"address":{
"line1":"20 EAST MAIN ST",
"city":"EAST ISLIP NY",
"postalCode":"55555",
"country":"USA"
},
"principals":[
{
"firstName":"ORLANDO",
"lastName":"BECKMAN",
"address":{
"line1":"73-52 243 STREET",
"city":"ST LOUIS",
"postalCode":"55555",
"country":"USA"
}
}
]
}
},
"meta":null,
"result":{
"TerminationInquiry":{
"PageOffset":0,
"Ref":"https:\/\/sandbox.api.mastercard.com\/fraud\/merchant\/v3\/termination-inquiry\/19962019110400034",
"TransactionReferenceNumber":"",
"PossibleMerchantMatches":[
{
"TotalLength":10,
"TerminatedMerchant":[
{
"Merchant":{
"Name":"TERMINATED MERCHANT 2",
"DoingBusinessAsName":"DOING BUSINESS AS TERMINATED MERCHANT 2",
"AddedByAcquirerID":"1996",
"AddedOnDate":"01\/09\/2019",
"PhoneNumber":"5555555555",
"Address":{
"Line1":"120 EAST MAIN ST",
"City":"EAST ISLIP",
"CountrySubdivision":"NY",
"PostalCode":"55555",
"Country":"USA"
},
"NationalTaxId":"*****",
"Principal":[
{
"FirstName":"ORLANDO",
"LastName":"BECKMAN",
"PhoneNumber":"5555555555",
"Address":{
"Line1":"73-52 243 STREET",
"City":"ST LOUIS",
"CountrySubdivision":"MO",
"PostalCode":"55555",
"Country":"USA"
},
"DriversLicense":[
]
}
],
"UrlGroup":[
{
"NoMatchUrls":{
"Url":[
"WWW.TESTJJ.COM",
"WWW.JNLTESTJJ.COM"
]
}
}
],
"TerminationReasonCode":"04"
},
"MerchantMatch":{
"Name":"M01",
"DoingBusinessAsName":"M02",
"Address":"M00",
"PhoneNumber":"M00",
"AltPhoneNumber":"M00",
"CountrySubdivisionTaxId":"M00",
"NationalTaxId":"M00",
"ServiceProvLegal":"M00",
"ServiceProvDBA":"M00",
"PrincipalMatch":[
{
"Name":"M01",
"Address":"M00",
"PhoneNumber":"M00",
"AltPhoneNumber":"M00",
"NationalId":"M00",
"DriversLicense":"M00"
}
]
}
},
{
"Merchant":{
"Name":"TERMINATED MERCHANT 2",
"DoingBusinessAsName":"DOING BUSINESS AS TERMINATED MERCHANT 2",
"AddedByAcquirerID":"1996",
"AddedOnDate":"01\/08\/2019",
"PhoneNumber":"5555555555",
"Address":{
"Line1":"120 EAST MAIN ST",
"City":"EAST ISLIP",
"CountrySubdivision":"NY",
"PostalCode":"55555",
"Country":"USA"
},
"CountrySubdivisionTaxId":"*****",
"NationalTaxId":"*****",
"Principal":[
{
"FirstName":"ORLANDO",
"LastName":"BECKMAN",
"NationalId":"*****",
"PhoneNumber":"5555555555",
"Address":{
"Line1":"73-52 243 STREET",
"City":"ST LOUIS",
"CountrySubdivision":"MO",
"PostalCode":"55555",
"Country":"USA"
},
"DriversLicense":[
]
}
],
"TerminationReasonCode":"13"
},
"MerchantMatch":{
"Name":"M01",
"DoingBusinessAsName":"M02",
"Address":"M00",
"PhoneNumber":"M00",
"AltPhoneNumber":"M00",
"CountrySubdivisionTaxId":"M00",
"NationalTaxId":"M00",
"ServiceProvLegal":"M00",
"ServiceProvDBA":"M00",
"PrincipalMatch":[
{
"Name":"M01",
"Address":"M00",
"PhoneNumber":"M00",
"AltPhoneNumber":"M00",
"NationalId":"M00",
"DriversLicense":"M00"
}
]
}
},
]
}
],
"PossibleInquiryMatches":[
{
"TotalLength":27,
"InquiredMerchant":[
{
"Merchant":{
"Name":"TERMINATED MERCHANT 2",
"DoingBusinessAsName":"DOING BUSINESS AS TERMINATED MERCHANT 2",
"Address":{
"Line1":"20 EAST MAIN ST",
"City":"EAST ISLIP",
"CountrySubdivision":"NY",
"PostalCode":"55555",
"Country":"USA"
},
"Principal":[
{
"FirstName":"ORLANDO",
"LastName":"BECKMAN",
"Address":{
"CountrySubdivision":"MO",
"PostalCode":"55555",
"Country":"USA"
},
"DriversLicense":[
]
}
]
},
"MerchantMatch":{
"Name":"M01",
"DoingBusinessAsName":"M02",
"Address":"M00",
"PhoneNumber":"M00",
"AltPhoneNumber":"M00",
"CountrySubdivisionTaxId":"M00",
"NationalTaxId":"M00",
"ServiceProvLegal":"M00",
"ServiceProvDBA":"M00",
"PrincipalMatch":[
{
"Name":"M01",
"Address":"M00",
"PhoneNumber":"M00",
"AltPhoneNumber":"M00",
"NationalId":"M00",
"DriversLicense":"M00"
}
]
}
},
{
"Merchant":{
"Name":"TERMINATED MERCHANT 2",
"DoingBusinessAsName":"DOING BUSINESS AS TERMINATED MERCHANT 2",
"Address":{
"Line1":"20 EAST MAIN ST",
"City":"EAST ISLIP",
"CountrySubdivision":"NY",
"PostalCode":"55555",
"Country":"USA"
},
"Principal":[
{
"FirstName":"ORLANDO",
"LastName":"BECKMAN",
"Address":{
"CountrySubdivision":"MO",
"PostalCode":"55555",
"Country":"USA"
},
"DriversLicense":[
]
}
]
},
"MerchantMatch":{
"Name":"M01",
"DoingBusinessAsName":"M02",
"Address":"M00",
"PhoneNumber":"M00",
"AltPhoneNumber":"M00",
"CountrySubdivisionTaxId":"M00",
"NationalTaxId":"M00",
"ServiceProvLegal":"M00",
"ServiceProvDBA":"M00",
"PrincipalMatch":[
{
"Name":"M01",
"Address":"M00",
"PhoneNumber":"M00",
"AltPhoneNumber":"M00",
"NationalId":"M00",
"DriversLicense":"M00"
}
]
}
},
}
}
]
}
}
}
]
}
TD - Treść Ksiąg Wieczystych HTML
Źródło umożliwia pobranie treści ksiąg wieczystych w postaci pliku HTML.
Przykładowe zapytanie
{
"source":"kw",
"method":"html",
"params":{
"number":["PO/12312312/2","PO/12312312/3","PO/12312312/4"],
"timeout": 300
}
}
Parametr timeout, określający maksymalny czas oczekiwania na odświeżenie danych, nie jest wymagany. Domyślna wartość to 300 sekund.
Przykładowa odpowiedź
{
"status": "quened",
"ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
Korzystając ze zwróconego identyfikatora, można pobrać zestaw danych zwracanych przez Elektroniczne Księgi Wieczyste.
curl --user:pass https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1
W odpowiedzi znajdzie się plik z treścią księgi wieczystej, zakodowany w Base64. Odpowiedź zawiera pobrany HTML ze strony https://przegladarka-ekw.ms.gov.pl/eukw_prz/KsiegiWieczyste/pokazWydruk dla zadanego numeru KW. W obecnym kształcie usługi zawartość księgi wieczystej nie jest dostępna w innej postaci niż HTML.
Przykładowy zestaw danych wywołując metode /result
{
"status":"done",
"ident":"63eb039d-9039-4e6c-a1a2-924e348c18c1",
"added":"2018-12-07 09:59:39",
"finished":"2018-12-07 09:59:40",
"user_account":null,
"progress":100,
"data":[
{
"task_id":171,
"source":"kw",
"method":"html",
"params":{
"number":["PO/12312312/2","PO/12312312/3","PO/12312312/4"],
},
"meta":null,
"result":[
{"number":"PO/12312312/2", "file":"JVBERJGLCB....1T0YK", "added":"2018-11-09 14:56:19"},
{"number":"PO/12312312/3", "file":"JVBERJGLCB....2T0YK", "added":"2018-11-09 14:56:20"},
{"number":"PO/12312312/4", "file":"JVBERJGLCB....3T0YK", "added":"2018-11-09 14:56:21"}
]
}
]
}