NAV Navbar
Curl

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:

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"}
         ]
      }
   ]
}