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.
W przypadku pytań prosimy o kontakt pod adresem: support@transparentdata.pl
TD - KRS CEIDG JSON
Źródło umożliwia pobranie wszystkich danych o podmiocie z rejestru KRS oraz CEIDG w formacie JSON.
Parametr przyjmowany na wejściu nip. Jest to numer NIP.
W celu pobrania danych, należy wykorzystać zwrócony identyfikator.
Request
| Nr | Nazwa Pola | Opis Pola | Format zmiennej | Dopuszczalne kategorie wartości | Wymagalność |
|---|---|---|---|---|---|
| 1 | source | nazwa źródła danych | string | krs_ceidg | wymagane |
| 2 | method | nazwa metody źródła danych dla odpisu krs ceidg json | string | data | wymagane |
| 3 | params | parametry zapytania | węzeł | wymagane | |
| 4 | nip | numer nip firmy | int | 10 cyfrowy numer NIP | wymagane |
Stare wersje API
| Numer wersji | Link |
|---|---|
| 1.0.1 | Dokumentacja |
Przykładowe zapytanie
{
"source":"krs_ceidg",
"method":"data",
"version": "2.0.0",
"params":{
"nip":"1231231231"
}
}
Przykładowa odpowiedź
{
"status": "quened",
"ident": "9903039d-63eb-4e6c-a3a6-48c18c1924e3"
}
curl --user:pass https://api.transparentdata.pl/key/result?ident=9903039d-63eb-4e6c-a3a6-48c18c1924e3
Response
| Nr | Nazwa Pola | Opis Pola | Format zmiennej | Dopuszczalne kategorie wartości | Wymagalność |
|---|---|---|---|---|---|
| 1 | status | status wykonania zadania | string | done (wykonane), quened (dodane do kolejki), in_progress( w trakcie wykonywania), error (błąd podczas próby generowania) | wymagane |
| 2 | ident | unikalny numer identyfikacyjny nadany przy zapytaniu | string | wymagane | |
| 3 | user_account | nazwa konta użytkownika | string/nullable | ciąg tekstowy/null | wymagane |
| 4 | progress | procentowa ilość wykonania zadania | int | 0-100 | wymagane |
| 5 | data | tablica z danymi | tablica(array) | wymagane | |
| 6 | task_id | indywidualny numer id nadany podczas tworzenia zadania | int | wymagane | |
| 7 | source | nazwa źródła danych | string | krs | wymagane |
| 8 | method | nazwa metody źródła danych dla odpisu krs json | string | data | wymagane |
| 9 | version | wersja API | string | ||
| 10 | params | parametry zapytania | węzeł | wymagane | |
| 11 | nip | numer nip | int | 10 cyfrowy numer NIP | wymagane |
| 12 | meta | metatagi | nullable | null | wymagane |
| 13 | result | rezultat zapytania | węzeł | wymagane | |
| 14 | krs | dane pochodzące z krs. Pełny opis znajduje się tutaj | array/nullable | tablica/null | wymagane |
| 15 | ceidg | dane pochodzące z ceidg. Pełny opis znajduje się tutaj | array/nullable | tablica/null | wymagane |
Przykładowy zestaw danych wywołując metode /result
{
"status": "done",
"ident": "8e8e269d-cf52-488a-a7c7-9564aac5a2b2",
"user_account": null,
"progress": 100,
"data": [
{
"task_id": 1179897,
"source": "krs_ceidg",
"method": "data",
"version": "2.0.0",
"params": {
"nip": "1231231231"
},
"meta": null,
"result": {
"krs": {
"1231231231": {
"entries": [
{
"number": 1,
"date": "2017-10-10",
"court": "SĄD REJONOWY POZNAŃ - NOWE MIASTO I WILDA W POZNANIU, VIII WYDZIAŁ GOSPODARCZY KRAJOWEGO REJESTRU SĄDOWEGO",
"description": "REJESTRACJA W KRAJOWYM REJESTRZE SĄDOWYM",
"reference_number": "PO.VIII NS-REJ.KRS/12345/67/890"
}
],
"data": [
{
"from": 1,
"to": 2,
"name": "SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ SPÓŁKA KOMANDYTOWA",
"court": null,
"legal_form": "SPÓŁKA KOMANDYTOWA",
"tax_number": "1231231231",
"economy_number": "123123123",
"is_organization": false,
"has_civil_law_partnership": false
}
],
"headquarters": [
{
"from": 1,
"to": 13,
"address": "ul. PRZYKŁADOWA, nr 1, lok. ---, miejsc. POZNAŃ, kod 61-774, poczta POZNAŃ, kraj POLSKA",
"headquarters": "kraj POLSKA, woj. WIELKOPOLSKIE, powiat POZNAŃ, gmina POZNAŃ, miejsc. POZNAŃ",
"email": null,
"website_url": null,
"location": {
"country": "POLSKA",
"county": "POZNAŃ",
"province": "WIELKOPOLSKIE",
"township": "POZNAŃ",
"municipality": "POZNAŃ",
"street": "PRZYKŁADOWA",
"building_number": "1",
"premises_number": null,
"zip_code": "61-774",
"post": "POZNAŃ"
}
}
],
"branches": [
{
"to": null,
"from": 7,
"name": "SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ W POZNANIU ODDZIAŁ W KRAKOWIE",
"order": "1",
"address": "ul. PRZYKŁADOWA, nr 1, lok. ---, miejsc. KRAKÓW, kod 12-123, poczta KRAKÓW, kraj POLSKA",
"location": {
"post": "KRAKÓW",
"county": "KRAKÓW",
"street": "PRZYKŁADOWA",
"country": "POLSKA",
"province": "MAŁOPOLSKIE",
"township": "KRAKÓW",
"zip_code": "12-123",
"municipality": "KRAKÓW",
"building_number": "8",
"premises_number": null
},
"headquarters": "kraj POLSKA, woj. MAŁOPOLSKIE, powiat KRAKÓW, gmina KRAKÓW, miejsc. KRAKÓW"
}
],
"contracts": [
{
"from": 1,
"to": null,
"order": 1,
"content": "PRZYJĘCIE PIERWOTNEJ WERSJI UMOWY SPÓŁKI. UCHYLONO § 2 I NADANO MU NOWE BRZMIENIE, UCHYLONO § 9 I NADANO MU NOWE BRZMIENIE,UCHYLONO CAŁĄ TREŚĆ UMOWY SPÓŁKI I NADANO JEJ NOWE BRZMIENIE WRAZ Z PRZYJĘCIEM TEKSTU JEDNOLITEGO."
}
],
"formations": [
{
"from": 1,
"to": null,
"circumstances": "PRZEKSZTAŁCENIE",
"information": "PODMIOT POWSTAŁ W WYNIKU PRZEKSZTAŁCENIA SPÓŁKI SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ W SPÓŁKĘ POD FIRMĄSPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ SPÓŁKA KOMANDYTOWA NA PODSTAWIE UCHWAŁY NADZWYCZAJNEGO ZGROMADZENIA WSPÓLNIKÓW",
"agreement": null
}
],
"formation_contributors": [
{
"from": 1,
"to": null,
"order": 1,
"name": "SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ,------",
"country": "POLSKA,",
"court": null,
"krs_number": "1231231231",
"economy_number": "1231231231",
"tax_number": "1231231231"
}
],
"shareholders": [
{
"to": null,
"from": 1,
"name": "ADAM NOWAK",
"order": "1",
"value": 4000,
"amount": 80,
"shares": "80 UDZIAŁÓW O ŁĄCZNEJ WARTOŚCI 4.000,00 ZŁ",
"has_all": 0,
"currency": "PLN",
"birth_date": null,
"first_name": "ADAM",
"krs_number": null,
"pesel_number": "85031706479",
"regon_number": null
}
],
"general_partners": [
{
"from": 1,
"to": 23,
"order": 1,
"name": "NOWAK",
"first_name": "ADAM",
"krs_number": null,
"personal_id_number": "12312312312",
"birth_date": null,
"economy_number": null,
"married": true,
"marital_property": false,
"limited_partner": true,
"agreed_contribution": "3.929,65 ZŁ",
"property_separation": false,
"contribution_in_kind": true,
"limited_legal_capacity": false,
"limited_partnership_sum": "1.000,00 ZŁ"
}
],
"partners": [
{
"to": null,
"from": 1,
"order": "1",
"married": 0,
"last_name": "NOWAK",
"birth_date": null,
"first_name": "ADAM",
"responsible": 0,
"pesel_number": "12312312312",
"marital_property": 0,
"property_separation": 0,
"limited_legal_capacity": 0
}
],
"founders": [
{
"to": null,
"from": 1,
"name": "NOWAK",
"order": "1",
"birth_date": null,
"first_name": "ADAM",
"krs_number": null,
"pesel_number": "12312312312",
"regon_number": null
}
],
"surveillance_authorities": [
{
"to": null,
"from": 4,
"content": "STAROSTA MIKOŁOWSKI"
}
],
"capitals": [
{
"to": null,
"from": 1,
"capital": "5 000,00 ZŁ",
"paid_in": null,
"share_value": null,
"capital_target": null,
"shares_quantity": null,
"uncovered_capital": null,
"contribution_in_kind": 0,
"max_preference_shares": null,
"max_conditional_shares": null,
"conditional_capital_increase": null
}
],
"contributions": [
{
"to": 11,
"from": 7,
"content": "700 000,00 ZŁ"
}
],
"share_issues": [
{
"to": null,
"from": 8,
"name": "A",
"order": "1",
"quantity": 132797000,
"preference": "AKCJE NIE SĄ UPRZYWILEJOWANE"
}
],
"representations": [
{
"from": 1,
"to": null,
"membership": 1,
"authorized_body": "WSPÓLNICY REPREZENTUJĄCY SPÓŁKĘ",
"representation": "UPRAWNIONYM DO SAMODZIELNEJ REPREZENTACJI SPÓŁKI JEST KOMPLEMENTARIUSZ."
}
],
"representatives": [
{
"from": 1,
"to": 2,
"membership": 1,
"order": 1,
"name": "SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ",
"first_name": null,
"krs_number": "1231231232",
"economy_number": "123123123",
"personal_id_number": null,
"birth_date": null,
"function": null,
"suspended": false,
"suspended_until": null
}
],
"supervision": [
{
"to": null,
"from": 2,
"membership": "1",
"representation": null,
"authorized_body": "KOMISJA REWIZYJNA"
}
],
"supervisors": [
{
"to": 5,
"from": 2,
"order": "1",
"last_name": "NOWAK",
"birth_date": null,
"first_name": "ADAM",
"membership": "1",
"pesel_number": "12312312312"
}
],
"proxies": [
{
"from": 5,
"to": 20,
"order": 1,
"last_name": "NOWAK",
"first_name": "ADAM",
"personal_id_number": "12312312312",
"birth_date": null,
"type": "PROKURA SAMOISTNA"
}
],
"plenipotentiaries": [
{
"to": null,
"from": 68,
"type": "PEŁNOMOCNICTWO DO SKŁADANIA OŚWIADCZEŃ WOLI NA DOKUMENTACH ZWIĄZANYCH Z DZIAŁALNOŚCIĄ KIEROWANEGO ODDZIAŁU W ĆMIELOWIE, A W SZCZEGÓLNOŚCI DO: 1. PODPISYWANIE UMÓW KREDYTOWYCH WRAZ Z CZŁONKIEM ZARZĄDU; 2. ZAWIERANIE UMÓW ZABEZPIECZAJĄCYCH WIERZYTELNOŚCI BANKU WYNIKAJĄCYCH Z DOKONANYCH CZYNNOŚCI BANKOWYCH...",
"order": "1",
"last_name": "NOWAK",
"birth_date": null,
"first_name": "ADAM",
"pesel_number": "12312312312"
}
],
"foreign_entrepreneur_representatives": [
{
"to": null,
"from": 1,
"order": "1",
"function": null,
"last_name": "NOWAK",
"birth_date": "1996-11-27",
"first_name": "ADAM",
"pesel_number": null
}
],
"activities": [
{
"from": 1,
"to": null,
"order": 1,
"priority": 1,
"code": "63.12.Z",
"content": "63, 12, Z, DZIAŁALNOŚĆ PORTALI INTERNETOWYCH"
}
],
"purposes": [
{
"to": null,
"from": 1,
"content": "CELEM FUNDACJI JEST: 1)WSPIERANIE, ROZWÓJ ORAZ PROMOCJA KULTURY FIZYCZNEJ I SPORTU, ZE SZCZEGÓLNYM UWZGLĘDNIENIEM LEKKOATLETYKI; 2)ROZWÓJ SZEROKO POJĘTEJ PROFILAKTYKI PROZDROWOTNEJ I EDUKACJA W TYM ZAKRESIE; 3)ZWIĘKSZENIE DOSTĘPNOŚCI DO AKTYWNOŚCI FIZYCZNEJ I PROFILAKTYKI ZDROWOTNEJ..."
}
],
"documents": [
{
"from": 3,
"to": null,
"order": 1,
"type": 1,
"date": "2018-07-18",
"period": "OD 10.10.2017 DO 31.12.2017"
}
],
"statute_subjects": [
{
"to": null,
"code": "94.99.Z",
"from": 6,
"paid": 1,
"order": "1",
"content": "94, 99, Z, NIESIENIE POMOCY W REHABILITACJI OFIAR WYPADKÓW KOMUNIKACYJNYCH I ZDARZEŃ LOSOWYCH"
}
],
"payment_arrears": [
{
"to": 7,
"end": null,
"from": 4,
"open": "NACZELNIK URZĘDU SKARBOWEGO",
"order": "1",
"amount": "116 939,55 ZŁ",
"nature": "PODATKOWA"
}
],
"debts": [
{
"to": null,
"from": 22,
"membership": "1",
"is_solidarity": 0,
"executive_title": "SĄD REJONOWY WYDZIAŁ CYWILNY",
"amount_or_description": "22489,93 ZŁ (13253,34 ZŁ TYTUŁEM NALEŻNOŚCI GŁÓWNEJ, 3564,56 ZŁ TYTUŁEM KOSZTÓW POSTĘPOWANIA, 5672,03 ZŁ TYTUŁEM ODSETEK LICZONYCH NA DZIEŃ 9.08.2024 R.)"
}
],
"debt_creditors": [
{
"to": null,
"from": 22,
"name": "SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ",
"order": "1",
"birth_date": null,
"first_name": null,
"krs_number": "1231231231",
"membership": "1",
"pesel_number": null,
"regon_number": null
}
],
"execution_cancellations": [
{
"to": null,
"from": 19,
"order": "2",
"content": "KOMORNIK SĄDOWY PRZY SĄDZIE REJONOWYM"
}
],
"superintendents": [
{
"to": null,
"from": 18,
"name": "NOWAK",
"order": "1",
"end_date": null,
"birth_date": null,
"first_name": "ADAM",
"krs_number": null,
"pesel_number": "12312312312",
"regon_number": null,
"appointment_date": "2024-11-08",
"appointment_basis": "POSTANOWIENIE SĄDU REJONOWEGO I WYDZIAŁU CYWILNEGO - ZAKRES DZIAŁANIA : REPREZENTACJA SPÓŁKI SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ SPÓŁKA KOMANDYTOWA W POSTĘPOWANIU PRZED SĄDEM"
}
],
"liquidations": [
{
"to": 15,
"end": null,
"from": 6,
"open": "UCHWAŁA NR 1 ZGROMADZENIA WSPÓLNIKÓW O ROZWIĄZANIU SPÓŁKI",
"end_date": null,
"open_date": "2023-08-21",
"membership": "1",
"representation": "JEDNOOSOBOWO"
}
],
"liquidators": [
{
"to": 15,
"from": 6,
"name": "NOWAK",
"order": "1",
"birth_date": null,
"first_name": "ADAM",
"krs_number": null,
"membership": "1",
"pesel_number": "12312312312",
"regon_number": null
}
],
"dissolutions": [
{
"to": 15,
"from": 6,
"information": "UCHWAŁA NR 1 ZGROMADZENIA WSPÓLNIKÓW O ROZWIĄZANIU SPÓŁKI",
"circumstances": "ROZWIĄZANIE"
}
],
"receiverships": [
{
"to": 18,
"from": 14,
"name": "NOWAK",
"order": "1",
"birth_date": null,
"first_name": "ADAM",
"krs_number": null,
"membership": "1",
"pesel_number": "12312312312",
"regon_number": null
}
],
"receivers": [
{
"to": 16,
"from": 14,
"membership": "1",
"establishment": "31.10.2017",
"representation": null
}
],
"transformations": [
{
"to": 18,
"from": 18,
"membership": "1",
"information": "KANCELARIA NOTARIALNA; UCHWAŁA NR 1 NADZWYCZAJNEGO ZEBRANIA WSPÓLNIKÓW W PRZEDMIOCIE PRZEKSZTAŁCENIA SPÓŁKI JAWNEJ W SPÓŁKĘ Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ ORAZ WYRAŻENIA ZGODY NA BRZMIENIE UMOWY SPÓŁKI PRZEKSZTAŁCONEJ",
"circumstances": "PRZEKSZTAŁCENIE W INNĄ SPÓŁKĘ HANDLOWĄ"
}
],
"transformation_beneficiaries": [
{
"to": 18,
"from": 18,
"name": "SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ,------",
"court": null,
"order": "1",
"register": "POLSKA,KRAJOWY REJESTR SĄDOWY",
"membership": "1",
"regon_number": "123123123",
"register_number": "1231231231"
}
],
"transformation_contributors": [
{
"to": null,
"from": 18,
"name": "SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ,---- --",
"court": null,
"order": "1",
"register": "KRAJOWY REJESTR SĄDOWY",
"membership": "1",
"regon_number": "123123123",
"register_number": null
}
],
"bankruptcies": [
{
"to": 16,
"from": 7,
"membership": "1",
"proceeding": null,
"termination": null,
"announcement": "SĄD REJONOWY WYDZIAŁ GOSPODARCZY DLA SPRAW UPADŁOŚCIOWYCH I RESTRUKTURYZACYJNYCH",
"cancellation": null
}
],
"bankruptcy_receivers": [
{
"to": null,
"from": 7,
"name": "NOWAK",
"order": "1",
"birth_date": null,
"first_name": "ADAM",
"krs_number": null,
"membership": "1",
"pesel_number": "12312312312",
"regon_number": null
}
],
"bankruptcy_appointed_people": [
{
"to": null,
"from": 26,
"name": "NOWAK",
"order": "1",
"function": "OSOBA POWOŁANA W TOKU POSTĘPOWANIA UPADŁOŚCIOWEGO DO REPREZENTOWANIA UPADŁEGO",
"birth_date": null,
"first_name": "ADAM",
"krs_number": null,
"membership": "1",
"pesel_number": "12312312312",
"regon_number": null
}
],
"arrangements": [
{
"to": null,
"end": null,
"from": 28,
"open": "SĄD REJONOWY W TORUNIU V WYDZIAŁ GOSPODARCZY",
"order": "1",
"information": null
}
],
"reconstructions": [
{
"to": null,
"end": null,
"from": 31,
"open": "SĄD REJONOWY W WAŁBRZYCHU VI WYDZIAŁ GOSPODARCZY, POSTĘPOWANIE RESTRUKTURYZACYJNE",
"membership": "1",
"information": null
}
],
"reconstructors": [
{
"to": null,
"from": 31,
"name": "NOWAK",
"order": "1",
"function": "NADZORCA SĄDOWY",
"birth_date": null,
"first_name": "ADAM",
"krs_number": null,
"membership": "1",
"pesel_number": "12312312312",
"regon_number": null
}
],
"suspensions": [
{
"to": null,
"from": 5,
"order": "1",
"end_on": null,
"open_on": "2024-11-15"
}
],
"id": 12312,
"global_id": 12312312,
"krs_number": "1231231231",
"register": "entrepreneurs",
"status": "active",
"downloaded_at": "2024-11-24 08:07:12"
},
"3232323232": {
...
}
},
"ceidg": {
"first_name":"ADAM JAN",
"last_name":"NOWAK",
"nip":"123123123",
"regon":"123123123",
"company_name":"Wypożyczalnia samochodów Adam Nowak",
"company_status":"Aktywny",
"beginning_date":"2018-01-10",
"suspended_from_date":null,
"suspended_to_date":null,
"ending_date":null,
"deletion_legal_basis":null,
"legal_basis_details":null,
"cancellation":null,
"has_community_of_goods":"0",
"pkd_version": "2025",
"main_pkd":"9609Z",
"nationality":null,
"electronic_delivery_address": "XX:PL-12345-12345-XXXXX-12",
"phone":"+48 100 001 001",
"fax":null,
"www":null,
"email":null,
"main_address":{
"street":"ul. Przykładowa",
"number":"2",
"local":"42",
"commune":"Warszawa",
"county":"Warszawa",
"region":"MAZOWIECKIE",
"post":"Warszawa",
"postcode":"01-123",
"city":"Warszawa"
},
"postal_address":{
"street":"ul. Przykładowa",
"number":"2",
"local":"42",
"commune":"Warszawa",
"county":"Warszawa",
"region":"MAZOWIECKIE",
"post":"Warszawa",
"postcode":"01-123",
"city":"Warszawa"
},
"in_civil_partnership":"1",
"civil_partnership_details":[
{
"nip":"1231231231",
"regon":"0123123123",
"activity_suspended":null,
"partners_nip_numbers":[
"121212121",
"121212121"
]
},
{
"nip":"121212121",
"regon":null,
"activity_suspended":null,
"partners_nip_numbers":[
"121212121"
]
}
],
"permissions":[
"od 2025-03-31 do 2030-03-31 Zezwolenie na sprzedaż napojów alkoholowych powyżej 18% zawartości alkoholu przeznaczonych do spożycia poza miejscem sprzedaży (wprowadzone przez Urząd Gminy)",
"od 2025-03-31 do 2030-03-31 Zezwolenie na sprzedaż napojów alkoholowych powyżej 18% zawartości alkoholu przeznaczonych do spożycia poza miejscem sprzedaży (wprowadzone przez Urząd Gminy)"
],
"restrictions":[
{
"description":"Tak",
"period":"5 lat",
"institution":"Sąd Rejonowy",
"file_number":"XY Exa 1/1",
"type":"Zakaz prowadzenia działalności gospodarczej",
"ruling_date":"2015-01-11",
"effective_date":"2015-02-02"
}
],
"agents":[
],
"extra_addresses":[
{
"street":"ul. Przykładowa",
"number":"2",
"local":"12",
"county":"Warszawa",
"region":"MAZOWIECKIE",
"post":"Warszawa",
"postcode":"00-123",
"city":"Warszawa"
}
],
"date_of_cessation_of_activity": null
}
}
}
]
}