NAV Navbar
Curl

Company Registers API

Welcome to the Transparent Data Company Information API technical documentation.

If you have any question please contact us: support@transparentdata.pl

The API provides international data from official business registers from the following countries:

Country Code
Czech Republic CZ
Denmark DK
Finland FI
Norway NO
Slovakia SK
United Kingdom UK

This data allows you to reduce the risk of cooperation and accelerate complicated compliance/KYC procedures.

Depending on the country, the scope of company information may vary.

Authentication

The API is available at https://api.transparentdata.pl/ API request should use the GET method. In order to start and make requests, you will need to obtain an API key. If you don’t have it yet, please visit our website www.transparentdata.eu/api-global/ and describe your business needs through a contact form.

Access to TD API resources requires authentication through the standard HTTP Basic Auth mechanisms.

A user receives credentials as follows:

A sample authentication:

 curl --user:pass https://api.transparentdata.pl/{key}/
Name Desc
user username
pass password required for authentication
key unique account id

All requests use SSL.

czSearch()

 curl --user:pass https://api.transparentdata.pl/{key}/czSearch?q=abc

A successfull sample API response (excerpt):


[
  {
    "ico": "22714839",
    "url_id": "788392",
    "company_status": "Aktivní",
    "company_name": "ABC Brno",
    "incorporation_date": "2014-01-01",
    "dissolution_date": null,
    "legal_form_code": "706",
    "legal_form_description": "Spolek",
    "main_address_id": "16510390",
    "main_address_street": "Údolní",
    "main_address_number": "420",
    "main_address_local": "13",
    "main_address_district": null,
    "main_address_city": "Brno",
    "main_address_postcode": "60200",
    "main_address_region": "Brno-město",
    "main_address_country": "Česká republika",
    "main_address_text": null,
    "registry_ident": "7/Krajský soud v Brně/L      16803",
    "registered_capital_amount": null,
    "paid_in_capital_amount": null,
    "is_liquidation": "0",
    "is_bankruptcy": "0",
    "relations": [],
    "list_values": [],
    "documents": [
      {
        "file_type": "certificate",
        "url": "https://or.justice.cz/ias/ui/print-pdf?subjektId=788392&typVypisu=UPLNY&full=false",
        "name": "Úplný výpis",
        "fs_name": "cz_22714839_788392.pdf"
      }
    ]
  },
  {
    "ico": "26428351",
    "url_id": "21041",
    "company_status": "Aktivní",
    "company_name": "ABC Nemo a.s.",
    "incorporation_date": "2001-01-18",
    "dissolution_date": null,
    "legal_form_code": "121",
    "legal_form_description": "Akciová společnost",
    "main_address_id": "22733943",
    "main_address_street": "Blatného",
    "main_address_number": "1896",
    "main_address_local": "3",
    "main_address_district": "Žabovřesky",
    "main_address_city": "Brno",
    "main_address_postcode": "61600",
    "main_address_region": "Brno-město",
    "main_address_country": "Česká republika",
    "main_address_text": null,
    "registry_ident": "7/Krajský soud v Brně/B       6556",
    "registered_capital_amount": "2000000.00",
    "paid_in_capital_amount": "100",
    "is_liquidation": "0",
    "is_bankruptcy": "0",
    "relations": [
      {
        "relation_type": "person",
        "role": "předseda představenstva",
        "role_code": "1",
        "pre_title": "Ing.",
        "first_name": "TOMÁŠ",
        "last_name": "SVOBODA",
        "post_title": null,
        "date_of_birth": "1967-07-22",
        "person_ident": "TOMASSVOBODA19670722",
        "company_name": null,
        "legal_form": null,
        "ico": null,
        "main_address_id": "22733956",
        "main_address_street": "Masarykova",
        "main_address_number": "65",
        "main_address_local": null,
        "main_address_district": null,
        "main_address_city": "Újezd u Brna",
        "main_address_postcode": "66453",
        "main_address_region": null,
        "main_address_country": "Česká republika",
        "main_address_text": null,
        "deposit": null,
        "paid": null,
        "business_share": null,
        "lien": null,
        "additional_info": null
      },
      {
        "relation_type": "person",
        "role": "člen dozorčí rady",
        "role_code": "4",
        "pre_title": "Mgr.",
        "first_name": "VIKTOR",
        "last_name": "JANČ",
        "post_title": null,
        "date_of_birth": "1959-04-23",
        "person_ident": "VIKTORJANC19590423",
        "company_name": null,
        "legal_form": null,
        "ico": null,
        "main_address_id": "22733968",
        "main_address_street": "Krátká",
        "main_address_number": "122",
        "main_address_local": null,
        "main_address_district": null,
        "main_address_city": "Sokolnice",
        "main_address_postcode": "66452",
        "main_address_region": "Brno-venkov",
        "main_address_country": "Česká republika",
        "main_address_text": null,
        "deposit": null,
        "paid": null,
        "business_share": null,
        "lien": null,
        "additional_info": null
      }
    ],
    "list_values": [
      {
        "list_type": "Předmět podnikání",
        "description": "výroba, obchod a služby neuvedené v přílohách 1 až 3 živnostenského zákona"
      },
      {
        "list_type": "Akcie",
        "description": "Kmenové akcie na jméno/200/10000;00 Kč"
      },
      {
        "list_type": "Způsob jednání",
        "description": "Společnost zastupuje  předseda představenstva"
      }
    ],
    "documents": [
      {
        "file_type": "certificate",
        "url": "https://or.justice.cz/ias/ui/print-pdf?subjektId=21041&typVypisu=UPLNY&full=false",
        "name": "Úplný výpis",
        "fs_name": "cz_26428351_21041.pdf"
      },
      {
        "file_type": "other",
        "url": "https://or.justice.cz/ias/ui/vypis-sl-detail?dokument=48319289&subjektId=21041&spis=687727",
        "name": "účetní závěrka [2016]",
        "fs_name": "cz_26428351_21041_doc_48319289.pdf"
      },
      {
        "file_type": "other",
        "url": "https://or.justice.cz/ias/ui/vypis-sl-detail?dokument=43201609&subjektId=21041&spis=687727",
        "name": "účetní závěrka [2015]",
        "fs_name": "cz_26428351_21041_doc_43201609.pdf"
      },
      {
        "file_type": "other",
        "url": "https://or.justice.cz/ias/ui/vypis-sl-detail?dokument=42214024&subjektId=21041&spis=687727",
        "name": "účetní závěrka [2014]",
        "fs_name": "cz_26428351_21041_doc_42214024.pdf"
      },
      {
        "file_type": "other",
        "url": "https://or.justice.cz/ias/ui/vypis-sl-detail?dokument=21664152&subjektId=21041&spis=687727",
        "name": "notářský zápis [NZ 332/2015] stanovy",
        "fs_name": "cz_26428351_21041_doc_21664152.pdf"
      },
      {
        "file_type": "other",
        "url": "https://or.justice.cz/ias/ui/vypis-sl-detail?dokument=17559571&subjektId=21041&spis=687727",
        "name": "účetní závěrka [2013] příloha",
        "fs_name": "cz_26428351_21041_doc_17559571.pdf"
      },
      {
        "file_type": "other",
        "url": "https://or.justice.cz/ias/ui/vypis-sl-detail?dokument=17554445&subjektId=21041&spis=687727",
        "name": "účetní závěrka [2013] výkaz",
        "fs_name": "cz_26428351_21041_doc_17554445.pdf"
      }
    ]
  }
]

A sample API response in case of no results:


[]

The method returns list of maximum 10 companies data rows from Transparent Data database, obtained from the company register of the Czech Republic, Veřejný rejstřík a Sbírka listin (justice.cz).

Parameter

Name Obligatory Description Additional info
q YES search phrase -

Data

Main company fields:

Fields in the relations section:

Fields in the list_values section:

Fields in the documents section:

dkSearch()

 curl --user:pass https://api.transparentdata.pl/{key}/dkSearch?q=abc

A successfull sample API response (excerpt):


[
  {
    "company_name": "ABC",
    "company_auxiliary_names": null,
    "company_number": "35156909",
    "company_ident": "35156909CVR",
    "company_type": "virksomhed",
    "main_address": "c/o Hollændervej 20 Hollændervej 20",
    "main_address_city_and_postcode": "2791 Dragør",
    "main_address_municipality": "Dragør",
    "incorporation_date": "2013-05-15",
    "dissolution_date": null,
    "legal_form": "Frivillig forening",
    "business_purpose_description": null,
    "company_status": "Aktiv",
    "main_type_of_business_activity": "949900 Andre organisationer og foreninger i.a.n.",
    "secondary_type_of_business_activity": null,
    "has_advertising_protection": "Nej",
    "related_company_number": null,
    "phone": "40254053",
    "fax": null,
    "email": "k-aagaard@privat.dk",
    "is_a_social_enterprise": null,
    "is_a_government_enterprise": null,
    "is_open_during_public_holidays": null,
    "holidays_financial_period": null,
    "credit_information": null,
    "details_about_power_to_bind": null,
    "financial_year": null,
    "latest_articles_of_association": null,
    "first_accounting_period": null,
    "registered_capital_amount": null,
    "has_company_different_classes_of_shares": null,
    "related_persons": [],
    "related_companies": [
      {
        "role": "P-enheder",
        "company_number": "1018485601",
        "company_ident": "1018485601P",
        "company_name": "ABC",
        "main_address": "c/o Hollændervej 20 Hollændervej 20",
        "main_address_city_and_postcode": "2791 Dragør",
        "main_address_country": null,
        "change_date": null,
        "divestiture_date": null,
        "share_capital_percent": null,
        "voting_rights_percent": null,
        "capital_class": null
      }
    ],
    "list_values": [],
    "documents": [
      {
        "file_type": "certificate",
        "storage_key": "245250_35156909_certificate_da.pdf",
        "description": null
      }
    ]
  },
  {
    "company_name": "ABC-Computer",
    "company_auxiliary_names": null,
    "company_number": "25454065",
    "company_ident": "25454065CVR",
    "company_type": "virksomhed",
    "main_address": "Bybækterrasserne 111 D",
    "main_address_city_and_postcode": "3520 Farum",
    "main_address_municipality": "Furesø",
    "incorporation_date": "2019-03-19",
    "dissolution_date": null,
    "legal_form": "Personligt ejet Mindre Virksomhed",
    "business_purpose_description": null,
    "company_status": "Aktiv",
    "main_type_of_business_activity": "620900 Anden it-servicevirksomhed",
    "secondary_type_of_business_activity": null,
    "has_advertising_protection": "Ja",
    "related_company_number": null,
    "phone": null,
    "fax": null,
    "email": "it@abc-computer.dk",
    "is_a_social_enterprise": null,
    "is_a_government_enterprise": null,
    "is_open_during_public_holidays": null,
    "holidays_financial_period": null,
    "credit_information": null,
    "details_about_power_to_bind": null,
    "financial_year": null,
    "latest_articles_of_association": null,
    "first_accounting_period": null,
    "registered_capital_amount": null,
    "has_company_different_classes_of_shares": null,
    "related_persons": [
      {
        "person_url_id": "4000361363",
        "full_name": "Anne Beth Holm Andersson",
        "main_address": "Bybækterrasserne 111 D",
        "main_address_city_and_postcode": "3520 Farum",
        "foreign_address": null,
        "role": "Fuldt ansvarlig deltager",
        "start_date": "2000-06-01",
        "end_date": "2000-08-01",
        "change_date": null,
        "divestiture_date": null,
        "share_capital_percent": null,
        "voting_rights_percent": null,
        "capital_class": null,
        "company_number": "25454065",
        "company_name": "ABC-Computer",
        "company_status": "Aktiv"
      }
    ],
    "related_companies": [
      {
        "role": "P-enheder",
        "company_number": "1007721362",
        "company_ident": "1007721362P",
        "company_name": "Holm Service                      V/Anne Beth Holm",
        "main_address": "Rugmarken 20",
        "main_address_city_and_postcode": "3520 Farum",
        "main_address_country": null,
        "change_date": null,
        "divestiture_date": null,
        "share_capital_percent": null,
        "voting_rights_percent": null,
        "capital_class": null
      },
      {
        "role": "P-enheder",
        "company_number": "1024517868",
        "company_ident": "1024517868P",
        "company_name": "ABC-Computer",
        "main_address": "Bybækterrasserne 111 D",
        "main_address_city_and_postcode": "3520 Farum",
        "main_address_country": null,
        "change_date": null,
        "divestiture_date": null,
        "share_capital_percent": null,
        "voting_rights_percent": null,
        "capital_class": null
      }
    ],
    "list_values": [
      {
        "list_type": "Historiske stamdata",
        "period": "01.06.2000 - 20.06.2000",
        "title": "Branchekode",
        "description": "980000 Uoplyst"
      },
      {
        "list_type": "Historiske stamdata",
        "period": "01.06.2000 - 01.08.2000",
        "title": "Virksomhedsnavn",
        "description": "Holm Service                      V/Anne Beth Holm"
      },
      {
        "list_type": "Historiske stamdata",
        "period": "01.06.2000 - 01.08.2000",
        "title": "Adresse",
        "description": "Rugmarken 20 3520 Farum"
      },
      {
        "list_type": "Historiske stamdata",
        "period": "01.06.2000 - 01.08.2000",
        "title": "Virksomhedsform",
        "description": "Enkeltmandsvirksomhed"
      },
      {
        "list_type": "Historiske stamdata",
        "period": "21.06.2000 - 01.08.2000",
        "title": "Branchekode",
        "description": "741200 Revisions- og bogføringsvirksomhed"
      }
    ],
    "documents": [
      {
        "file_type": "certificate",
        "storage_key": "883500_25454065_certificate_da.pdf",
        "description": null
      }
    ]
  },

A sample API response in case of no results:


[]

The method returns list of maximum 10 companies data rows from Transparent Data database, obtained from the central company register of Denmark, Det Centrale Virksomhedsregister CVR Virk (virk.dk).

Parameter

Name Obligatory Description Additional info
q YES search phrase -

Data

Main company fields:

Fields in the related_persons section:

Fields in the related_companies section:

Fields in the list_values section:

Fields in the documents section:

fiSearch()

 curl --user:pass https://api.transparentdata.pl/{key}/fiSearch?q=abc

A successfull sample API response (excerpt):


[
  {
    "company_name": "ABC-Studiot Oy - ABC-Studios Ltd.",
    "company_auxiliary_names": "[]",
    "business_id": "0938236-7",
    "trade_register_number": "568.454",
    "url_type": "company",
    "url_id": "-1993039443",
    "legal_form": "Osakeyhtiö",
    "company_status": "Rekisterissä",
    "company_language": "suomi",
    "main_address": null,
    "main_address_postcode": null,
    "main_address_city": null,
    "main_address_country": null,
    "post_address": "JOKIPELLONTIE 401 A",
    "post_address_postcode": "03300",
    "post_address_city": "OTALAMPI",
    "post_address_country": "Suomi",
    "website": null,
    "email": null,
    "phone": null,
    "fax": null,
    "incorporation_date": "25.08.1993",
    "dissolution_date": null,
    "dissolution_type": null,
    "main_type_of_business_activity_code": "74201",
    "main_type_of_business_activity_description": "Valokuvaamot ja muu kuvaustoiminta",
    "establishment_permission_date": null,
    "last_registration_date": "08.03.2019",
    "company_info_record_date": "25.08.1993",
    "last_by_law_amendment_date": null,
    "liquidation_type": null,
    "other_business_ids": "[]",
    "registered_office": "Helsinki",
    "has_enterprise_mortgages": "Ei"
  },
  {
    "company_name": "ABC-Ryhmä Oy",
    "company_auxiliary_names": "[]",
    "business_id": "2371317-7",
    "trade_register_number": null,
    "url_type": null,
    "url_id": null,
    "legal_form": "Osakeyhtiö",
    "company_status": "Rekisterissä",
    "company_language": "Svenska",
    "main_address": "ABC-GRUPPEN AB, Sibyllegatan 47, 1   114 42 Stockholm SWEDEN",
    "main_address_postcode": null,
    "main_address_city": null,
    "main_address_country": null,
    "post_address": "ABC-GRUPPEN AB, Sibyllegatan 47, 1   114 42 Stockholm SWEDEN",
    "post_address_postcode": null,
    "post_address_city": null,
    "post_address_country": null,
    "website": null,
    "email": null,
    "phone": null,
    "fax": null,
    "incorporation_date": "2010-11-16",
    "dissolution_date": null,
    "dissolution_type": null,
    "main_type_of_business_activity_code": "18120",
    "main_type_of_business_activity_description": "Muu painaminen",
    "establishment_permission_date": null,
    "last_registration_date": null,
    "company_info_record_date": null,
    "last_by_law_amendment_date": null,
    "liquidation_type": null,
    "other_business_ids": "[]",
    "registered_office": null,
    "has_enterprise_mortgages": null
  }
]

A sample API response in case of no results:


[]

The method returns list of maximum 10 companies data rows from Transparent Data database, obtained from the company register of Finland, Virre Information Service PRH (virre.prh.fi).

Parameter

Name Obligatory Description Additional info
q YES search phrase -

Data

Main company fields:

noSearch()

 curl --user:pass https://api.transparentdata.pl/{key}/noSearch?q=abc

A successfull sample API response (excerpt):


[
  {
    "company_number": "994613413",
    "company_name": "ABC REVISJON AS",
    "parent_entity": null,
    "origin_country_register_number": null,
    "company_status": "active",
    "language_form": "Bokmål",
    "legal_form": "AS",
    "legal_form_code": "AS",
    "legal_form_description": "Aksjeselskap",
    "institutional_sector_code": "2100",
    "institutional_sector_description": "Private aksjeselskaper mv.",
    "business_scope": "Revisjonstjenester. Regnskapstjenster.",
    "main_type_of_business_activity": "69.202",
    "main_type_of_business_activity_description": "Revisjon",
    "secondary_type_of_business_activity": null,
    "secondary_type_of_business_activity_description": null,
    "tertiary_type_of_business_activity": null,
    "tertiary_type_of_business_activity_description": null,
    "website": null,
    "incorporation_date": "2009-10-02",
    "unit_registration_date": "2009-10-07",
    "commencement_date": null,
    "ownership_date": null,
    "dissolution_date": null,
    "is_in_volunteer_register": "N",
    "is_in_vat_register": "J",
    "is_in_business_enterprises_register": "J",
    "is_in_foundations_register": "N",
    "is_bancrupt": "N",
    "is_in_liquidation": "N",
    "is_in_compulsory_or_enforced_liquidation": "N",
    "voluntarily_vat_registered": null,
    "main_address": "Øvre Langgate 26",
    "main_address_postcode": "3110",
    "main_address_city": "TØNSBERG",
    "main_address_municipality_code": "0704",
    "main_address_municipality": "TØNSBERG",
    "main_address_country_code": "NO",
    "main_address_country": "Norge",
    "post_address": null,
    "post_address_postcode": null,
    "post_address_city": null,
    "post_address_municipality_code": null,
    "post_address_municipality": null,
    "post_address_country_code": null,
    "post_address_country": null,
    "location_address": null,
    "location_address_postcode": null,
    "location_address_city": null,
    "location_address_municipality_code": null,
    "location_address_municipality": null,
    "location_address_country_code": null,
    "location_address_country": null,
    "number_of_employees": "5",
    "last_submitted_annual_accounts": "2018",
    "statutory_purpose": "Revisjons-, regnskaps- og rådgivningstjenester og hertil tilhørende konsulentvirksomhet.",
    "special_information": "Registrert i Foretaksregisteret\nRegistrert i Merverdiavgiftsregisteret\nRegistrert i NAV Aa-registeret\nSist innsendte årsregnskap 2018",
    "signature": "To styremedlemmer i fellesskap.",
    "procuration": null,
    "relations": [
      {
        "relation_type": "person",
        "name": "Trond Dørum Lillebakk",
        "ident": "TRONDLILLEBAKK",
        "role": "Daglig leder/ adm.direktør",
        "description": null,
        "main_address": null,
        "main_address_postcode": null,
        "main_address_city": null,
        "main_address_region": null,
        "main_address_country": null
      },
      {
        "relation_type": "person",
        "name": "Trond Dørum Lillebakk",
        "ident": "TRONDLILLEBAKK",
        "role": "Styremedlem",
        "description": null,
        "main_address": null,
        "main_address_postcode": null,
        "main_address_city": null,
        "main_address_region": null,
        "main_address_country": null
      },
      {
        "relation_type": "person",
        "name": "Tor Arne Andreassen",
        "ident": "TORANDREASSEN",
        "role": "Styrets leder",
        "description": null,
        "main_address": null,
        "main_address_postcode": null,
        "main_address_city": null,
        "main_address_region": null,
        "main_address_country": null
      },
      {
        "relation_type": "person",
        "name": "Arild Wulff Ytredal",
        "ident": "ARILDYTREDAL",
        "role": "Styremedlem",
        "description": null,
        "main_address": null,
        "main_address_postcode": null,
        "main_address_city": null,
        "main_address_region": null,
        "main_address_country": null
      },
      {
        "relation_type": "company",
        "name": "BDT VIKEN REVISJON AS",
        "ident": "980995151",
        "role": "Revisor",
        "description": "Godkjent revisjonsselskap",
        "main_address": "Vestre Braarudgate 2",
        "main_address_postcode": "3181",
        "main_address_city": "HORTEN",
        "main_address_region": null,
        "main_address_country": null
      },
      {
        "relation_type": "company",
        "name": "ABC REVISJON AS AVDELING TØNSBERG",
        "ident": "994621181",
        "role": "Virksomhet",
        "description": null,
        "main_address": null,
        "main_address_postcode": null,
        "main_address_city": null,
        "main_address_region": null,
        "main_address_country": null
      },
      {
        "relation_type": "company",
        "name": "ABC REVISJON AS AVDELING OSLO",
        "ident": "996561097",
        "role": "Virksomhet",
        "description": null,
        "main_address": null,
        "main_address_postcode": null,
        "main_address_city": null,
        "main_address_region": null,
        "main_address_country": null
      }
    ]
  },
  {
    "company_number": "913960750",
    "company_name": "ABC ACCOUNTING AS",
    "parent_entity": null,
    "origin_country_register_number": null,
    "company_status": "active",
    "language_form": "Bokmål",
    "legal_form": "AS",
    "legal_form_code": "AS",
    "legal_form_description": "Aksjeselskap",
    "institutional_sector_code": "2100",
    "institutional_sector_description": "Private aksjeselskaper mv.",
    "business_scope": "Salg av regnskaps og bokføringstjenester. Bedriftsrådgivning, generell databistand og andre produkter/tjenester som naturlig hører sammen med dette, herunder å delta i andre selskap med lignende virksomhet, og kjøp og salg av aksjer eller på annen måte gjøre seg interessert i andre foretak.",
    "main_type_of_business_activity": "69.201",
    "main_type_of_business_activity_description": "Regnskap og bokføring",
    "secondary_type_of_business_activity": null,
    "secondary_type_of_business_activity_description": null,
    "tertiary_type_of_business_activity": null,
    "tertiary_type_of_business_activity_description": null,
    "website": null,
    "incorporation_date": "2014-07-08",
    "unit_registration_date": "2014-08-01",
    "commencement_date": null,
    "ownership_date": null,
    "dissolution_date": null,
    "is_in_volunteer_register": "N",
    "is_in_vat_register": "J",
    "is_in_business_enterprises_register": "J",
    "is_in_foundations_register": "N",
    "is_bancrupt": "N",
    "is_in_liquidation": "N",
    "is_in_compulsory_or_enforced_liquidation": "N",
    "voluntarily_vat_registered": null,
    "main_address": "Selma Ellefsens vei 6",
    "main_address_postcode": "0581",
    "main_address_city": "OSLO",
    "main_address_municipality_code": "0301",
    "main_address_municipality": "OSLO",
    "main_address_country_code": "NO",
    "main_address_country": "Norge",
    "post_address": null,
    "post_address_postcode": null,
    "post_address_city": null,
    "post_address_municipality_code": null,
    "post_address_municipality": null,
    "post_address_country_code": null,
    "post_address_country": null,
    "location_address": null,
    "location_address_postcode": null,
    "location_address_city": null,
    "location_address_municipality_code": null,
    "location_address_municipality": null,
    "location_address_country_code": null,
    "location_address_country": null,
    "number_of_employees": "8",
    "last_submitted_annual_accounts": "2018",
    "statutory_purpose": "Salg av regnskaps og bokføringstjenester. Bedriftsrådgivning, generell databistand og andre produkter/tjenester som naturlig hører sammen med dette, herunder å delta i andre selskap med lignende virksomhet, og kjøp og salg av aksjer eller på annen måte gjøre seg interessert i andre foretak.",
    "special_information": "Registrert i Foretaksregisteret\nRegistrert i Merverdiavgiftsregisteret\nRegistrert i NAV Aa-registeret\nSist innsendte årsregnskap 2018",
    "signature": "Daglig leder alene.",
    "procuration": null,
    "relations": [
      {
        "relation_type": "person",
        "name": "Ishtiaq Ahmed",
        "ident": "ISHTIAQAHMED",
        "role": "Daglig leder/ adm.direktør",
        "description": null,
        "main_address": null,
        "main_address_postcode": null,
        "main_address_city": null,
        "main_address_region": null,
        "main_address_country": null
      },
      {
        "relation_type": "person",
        "name": "Ishtiaq Ahmed",
        "ident": "ISHTIAQAHMED",
        "role": "Styremedlem",
        "description": null,
        "main_address": null,
        "main_address_postcode": null,
        "main_address_city": null,
        "main_address_region": null,
        "main_address_country": null
      },
      {
        "relation_type": "person",
        "name": "Simon Frede Dahl",
        "ident": "SIMONDAHL",
        "role": "Styrets leder",
        "description": null,
        "main_address": null,
        "main_address_postcode": null,
        "main_address_city": null,
        "main_address_region": null,
        "main_address_country": null
      },
      {
        "relation_type": "person",
        "name": "Zaheer Shafi",
        "ident": "ZAHEERSHAFI",
        "role": "Styremedlem",
        "description": null,
        "main_address": null,
        "main_address_postcode": null,
        "main_address_city": null,
        "main_address_region": null,
        "main_address_country": null
      },
      {
        "relation_type": "company",
        "name": "REGISTRERT REVISOR BENT G JOHANSEN",
        "ident": "961072557",
        "role": "Revisor",
        "description": "Registrert ansvarlig revisor",
        "main_address": "Ryensvingen 3",
        "main_address_postcode": "0680",
        "main_address_city": "OSLO",
        "main_address_region": null,
        "main_address_country": null
      },
      {
        "relation_type": "company",
        "name": "ABC ACCOUNTING AS",
        "ident": "913966538",
        "role": "Virksomhet",
        "description": null,
        "main_address": null,
        "main_address_postcode": null,
        "main_address_city": null,
        "main_address_region": null,
        "main_address_country": null
      },
      {
        "relation_type": "person",
        "name": "Knut Tørnblad",
        "ident": "KNUTTORNBLAD",
        "role": "Nestleder",
        "description": null,
        "main_address": null,
        "main_address_postcode": null,
        "main_address_city": null,
        "main_address_region": null,
        "main_address_country": null
      },
      {
        "relation_type": "person",
        "name": "Ingrid Korsmo",
        "ident": "INGRIDKORSMO",
        "role": "Styremedlem",
        "description": null,
        "main_address": null,
        "main_address_postcode": null,
        "main_address_city": null,
        "main_address_region": null,
        "main_address_country": null
      }
    ]
  }
]

A sample API response in case of no results:


[]

The method returns list of maximum 10 companies data rows from Transparent Data database, obtained from the company register of Norway, Brønnøysundregistrene (brreg.no).

Parameter

Name Obligatory Description Additional info
q YES search phrase -

Data

Main company fields:

Fields in the relations section:

skSearch()

 curl --user:pass https://api.transparentdata.pl/{key}/skSearch?q=abc

A successfull sample API response (excerpt):


[
  {
    "district_court_id": "8",
    "url_id_by_district_court_id": "81348",
    "section": "Sro",
    "insert_number": "17691/P",
    "ico": "36665894",
    "company_name": "ABC Stropkov, s.r.o.",
    "legal_form": "Spoločnosť s ručením obmedzeným",
    "main_address_street": "Chotčanská",
    "main_address_number": "53",
    "main_address_local": "148",
    "main_address_city": "Stropkov",
    "main_address_postcode": "091 01",
    "main_address_country": null,
    "incorporation_date": "2006-08-18",
    "dissolution_date": null,
    "registered_capital": "10 623",
    "registered_capital_currency": "EUR",
    "paid_in_capital": "10 623",
    "paid_in_capital_currency": "EUR",
    "relations": [
      {
        "relation_type": "person",
        "role": null,
        "role_type": "Spoločníci",
        "additional_role": null,
        "company_name": null,
        "ico": null,
        "pre_title": null,
        "first_name": "Lukáš",
        "last_name": "Hamřík",
        "post_title": null,
        "person_ident": "LUKASHAMRIK",
        "mark": null,
        "start_date": null,
        "main_address_street": "Andreja Hlinku",
        "main_address_number": "1079",
        "main_address_local": "1",
        "main_address_city": "Stropkov",
        "main_address_postcode": "091 01",
        "main_address_country": null,
        "local_residence_address_street": "Andreja Hlinku",
        "local_residence_address_number": "1079",
        "local_residence_address_local": "1",
        "local_residence_address_city": "Stropkov",
        "local_residence_address_postcode": "091 01",
        "registered_capital": "10 623",
        "registered_capital_currency": "EUR",
        "registered_capital_info": null,
        "paid_in_capital": "10 623",
        "paid_in_capital_currency": "EUR"
      },
      {
        "relation_type": "person",
        "role": null,
        "role_type": "Štatutárny orgán",
        "additional_role": null,
        "company_name": null,
        "ico": null,
        "pre_title": null,
        "first_name": "Zdeněk",
        "last_name": "Hamřík",
        "post_title": null,
        "person_ident": "ZDENEKHAMRIK",
        "mark": null,
        "start_date": "2006-08-18",
        "main_address_street": "A. Hlinku",
        "main_address_number": "1079",
        "main_address_local": "1",
        "main_address_city": "Stropkov",
        "main_address_postcode": "091 01",
        "main_address_country": null,
        "local_residence_address_street": "A. Hlinku",
        "local_residence_address_number": "1079",
        "local_residence_address_local": "1",
        "local_residence_address_city": "Stropkov",
        "local_residence_address_postcode": "091 01",
        "registered_capital": null,
        "registered_capital_currency": null,
        "registered_capital_info": null,
        "paid_in_capital": null,
        "paid_in_capital_currency": null
      }
    ],
    "list_values": [
      {
        "list_type": "Predmet činnosti",
        "description": "kúpa tovaru na účely jeho predaja konečnému spotrebiteľovi (maloobchod) v rozsahu voľných živností"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "kúpa tovaru na účely jeho predaja iným prevádzkovateľom živnosti (veľkoobchod) v rozsahu voľných živností"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "sprostredkovanie obchodu a služieb v rozsahu voľných živností"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "spracovanie dreva a jednoduchých drevárskych výrobkov"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "demolácie, búracie práce a prípravné práce pre stavbu"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "zemné práce"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "čalúnnictvo"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "výroba jednoduchých výrobkov z dreva"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "zváračské a paličské práce"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "predaj nápojov na priamu konzumáciu"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "oprava obuvi a iných kožených výrobkov"
      },
      {
        "list_type": "Štatutárny orgán",
        "description": "konateľ"
      },
      {
        "list_type": "Konanie menom spoločnosti",
        "description": "Za spoločnosť koná a podpisuje konateľ samostatne a to tak, že k obchdnému menu spoločnosti pripojí svoj vlastnoručný podpis."
      }
    ]
  },
  {
    "district_court_id": "7",
    "url_id_by_district_court_id": "362007",
    "section": "Sro",
    "insert_number": "38519/T",
    "ico": "50539795",
    "company_name": "ABC JOBS s.r.o.",
    "legal_form": "Spoločnosť s ručením obmedzeným",
    "main_address_street": "ul. Z. Kodálya",
    "main_address_number": "787",
    "main_address_local": "6",
    "main_address_city": "Galanta",
    "main_address_postcode": "924 01",
    "main_address_country": null,
    "incorporation_date": "2016-10-11",
    "dissolution_date": null,
    "registered_capital": "30 000",
    "registered_capital_currency": "EUR",
    "paid_in_capital": "30 000",
    "paid_in_capital_currency": "EUR",
    "relations": [
      {
        "relation_type": "person",
        "role": null,
        "role_type": "Spoločníci",
        "additional_role": null,
        "company_name": null,
        "ico": null,
        "pre_title": null,
        "first_name": "Oľga",
        "last_name": "Kmeťová",
        "post_title": null,
        "person_ident": "OLGAKMETOVA",
        "mark": null,
        "start_date": null,
        "main_address_street": "Björnsonova",
        "main_address_number": "3044",
        "main_address_local": "4",
        "main_address_city": "Bratislava - mestská časť Staré Mesto",
        "main_address_postcode": "811 05",
        "main_address_country": null,
        "local_residence_address_street": "Björnsonova",
        "local_residence_address_number": "3044",
        "local_residence_address_local": "4",
        "local_residence_address_city": "Bratislava - mestská časť Staré Mesto",
        "local_residence_address_postcode": "811 05",
        "registered_capital": "30 000",
        "registered_capital_currency": "EUR",
        "registered_capital_info": null,
        "paid_in_capital": "30 000",
        "paid_in_capital_currency": "EUR"
      },
      {
        "relation_type": "person",
        "role": null,
        "role_type": "Štatutárny orgán",
        "additional_role": null,
        "company_name": null,
        "ico": null,
        "pre_title": null,
        "first_name": "Oľga",
        "last_name": "Kmeťová",
        "post_title": null,
        "person_ident": "OLGAKMETOVA",
        "mark": null,
        "start_date": "2017-06-15",
        "main_address_street": "Björnsonova",
        "main_address_number": "3044",
        "main_address_local": "4",
        "main_address_city": "Bratislava - mestská časť Staré Mesto",
        "main_address_postcode": "811 05",
        "main_address_country": null,
        "local_residence_address_street": "Björnsonova",
        "local_residence_address_number": "3044",
        "local_residence_address_local": "4",
        "local_residence_address_city": "Bratislava - mestská časť Staré Mesto",
        "local_residence_address_postcode": "811 05",
        "registered_capital": null,
        "registered_capital_currency": null,
        "registered_capital_info": null,
        "paid_in_capital": null,
        "paid_in_capital_currency": null
      }
    ],
    "list_values": [
      {
        "list_type": "Predmet činnosti",
        "description": "Kúpa tovaru na účely jeho predaja konečnému spotrebiteľovi (maloobchod) alebo iným prevádzkovateľom živnosti (veľkoobchod)"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "Sprostredkovateľská činnosť v oblasti obchodu, služieb, výroby"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "Reklamné a marketingové služby, prieskum trhu a verejnej mienky"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "Administratívne služby"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "Poskytovanie služieb v lesníctve a poľovníctve"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "Poskytovanie služieb rýchleho občerstvenia v spojení s predajom na priamu konzumáciu"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "Údržba motorových vozidiel bez zásahu do motorickej časti vozidla"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "Prípravné práce k realizácii stavby"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "Dokončovacie stavebné práce pri relizácii exteriérov a interiérov"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "Prenájom hnuteľných vecí"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "Ubytovacie služby bez poskytovania pohostinských činností"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "Finančný lízing"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "Čistiace a upratovacie služby"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "Činnosť podnikateľských, organizačných a ekonomických poradcov"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "Nákladná cestná doprava vykonávaná vozidlami s celkovou hmotnosťou do 3,5 t vrátane prípojného vozidla"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "Uskutočňovanie stavieb a ich zmien"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "Poskytovanie služieb osobného charakteru"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "Opracovanie drevenej hmoty a výroba komponentov z dreva"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "Výroba jednoduchých výrobkov z dreva, korku, slamy, prútia a ich úprava, oprava a údržba"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "Skladovanie a pomocné činnosti v doprave"
      },
      {
        "list_type": "Predmet činnosti",
        "description": "Činnosť agentúry dočasného zamestnávania"
      },
      {
        "list_type": "Štatutárny orgán",
        "description": "konateľ"
      },
      {
        "list_type": "Konanie menom spoločnosti",
        "description": "V mene spoločnosti koná konateľ samostatne. Pri právnych úkonoch vykonávaných v písomnej forme pripojí k obchodnému menu spoločnosti svoj podpis."
      }
    ]
  }
]

A sample API response in case of no results:


[]

The method returns list of maximum 10 companies data rows from Transparent Data database, obtained from the company register of Slovakia, Obchodný register (orsr.sk).

Parameter

Name Obligatory Description Additional info
q YES search phrase -

Data

Main company fields:

Fields in the relations section:

Fields in the list_values section:

ukSearch()

 curl --user:pass https://api.transparentdata.pl/{key}/ukSearch?q=abc

A successfull sample API response (excerpt):


[
  {
    "company_name": "1 ABC CAMBRIDGE ROAD SW11 MANAGEMENT COMPANY LIMITED",
    "company_number": "07394914",
    "company_status": "active",
    "category": "private-limited-guarant-nsc",
    "subcategory": null,
    "country_of_origin": "United Kingdom",
    "incorporation_date": "2010-10-04",
    "dissolution_date": null,
    "main_address_care_of": null,
    "main_address_pobox": null,
    "main_address_line_1": "1 Rushmills",
    "main_address_line_2": null,
    "main_address_post_town": "Northampton",
    "main_address_post_county": null,
    "main_address_post_country": "England",
    "main_address_postcode": "NN4 7YB",
    "sic1": "98000",
    "sic2": null,
    "sic3": null,
    "sic4": null,
    "account_ref_day": "31",
    "account_ref_month": "12",
    "account_next_due": "2020-09-30",
    "account_last_made_up": "2018-12-31",
    "account_category": "micro-entity",
    "returns_next_due": null,
    "returns_last_made_up": null,
    "insolvency_status": null,
    "etag": "44c2d2816e8f133b6db656d15b3353fe4a5d7aa1",
    "relations": [
      {
        "relation_type": "person",
        "ident": "6IyM0IvA80s7Qhh2RJzH_pgwJjY",
        "company_name": null,
        "first_name": "Douglas James",
        "last_name": "SCOTT",
        "role": "director",
        "nationality": "Welsh",
        "country_residence": "England",
        "occupation": "None",
        "start_date": "2010-10-04",
        "end_date": null,
        "main_address_line_1": "Rushmills",
        "main_address_line_2": null,
        "main_address_locality": "Northampton",
        "main_address_postcode": "NN4 7YB",
        "main_address_region": null,
        "main_address_country": "England",
        "main_address_premises": "1",
        "day_of_birth": null,
        "month_of_birth": "3",
        "year_of_birth": "1960"
      },
      {
        "relation_type": "person",
        "ident": "ck3i1L0UUX66ywN1Lin77tVMo7w",
        "company_name": null,
        "first_name": "Stephen John",
        "last_name": "DAVIES",
        "role": "director",
        "nationality": "British",
        "country_residence": "United Kingdom",
        "occupation": "None",
        "start_date": "2010-10-04",
        "end_date": null,
        "main_address_line_1": "Rushmills",
        "main_address_line_2": null,
        "main_address_locality": "Northampton",
        "main_address_postcode": "NN4 7YB",
        "main_address_region": null,
        "main_address_country": "England",
        "main_address_premises": "1",
        "day_of_birth": null,
        "month_of_birth": "2",
        "year_of_birth": "1976"
      },
      {
        "relation_type": "company",
        "ident": "cneFkwvyQrek1JDlf9qV9VvKQV0",
        "company_name": "URANG PROPERTY MANAGEMENT LIMITED",
        "first_name": null,
        "last_name": null,
        "role": "corporate-secretary",
        "nationality": null,
        "country_residence": null,
        "occupation": null,
        "start_date": "2012-01-18",
        "end_date": "2014-10-01",
        "main_address_line_1": "New Kings Road",
        "main_address_line_2": null,
        "main_address_locality": "London",
        "main_address_postcode": "SW6 4NF",
        "main_address_region": null,
        "main_address_country": "United Kingdom",
        "main_address_premises": "196",
        "day_of_birth": null,
        "month_of_birth": null,
        "year_of_birth": null
      },
      {
        "relation_type": "person",
        "ident": "NlCPN7KjqIzlfFO1AiDQarEJtQs",
        "company_name": null,
        "first_name": "Jon Dominic",
        "last_name": "MELTON",
        "role": "director",
        "nationality": "British",
        "country_residence": "United Kingdom",
        "occupation": "None",
        "start_date": "2010-10-04",
        "end_date": "2012-12-12",
        "main_address_line_1": "New Kings Road",
        "main_address_line_2": null,
        "main_address_locality": "London",
        "main_address_postcode": "SW6 4NF",
        "main_address_region": null,
        "main_address_country": "United Kingdom",
        "main_address_premises": "196",
        "day_of_birth": null,
        "month_of_birth": "4",
        "year_of_birth": "1976"
      }
    ],
    "people_with_significant_control": [
      {
        "relation_type": "individual-person-with-significant-control",
        "ident": "_PywCigIobAph9zekmHD4TpU2_Q",
        "full_name": "Ms Roberta Baldan",
        "first_name": "Roberta",
        "middle_name": null,
        "last_name": "Baldan",
        "pre_title": "Ms",
        "nationality": "Italian",
        "country_residence": null,
        "main_address_line_1": "Rushmills",
        "main_address_line_2": null,
        "main_address_locality": "Northampton",
        "main_address_postcode": "NN4 7YB",
        "main_address_country": "England",
        "main_address_premises": "1",
        "day_of_birth": null,
        "month_of_birth": "3",
        "year_of_birth": "1971",
        "etag": "db574e56e2f0183885c991f7cbea0c3e9a399105",
        "url_to_source": "/company/07394914/persons-with-significant-control/individual/_PywCigIobAph9zekmHD4TpU2_Q",
        "notified_on": null,
        "ownership_of_shares": null,
        "part_right_to_share_surplus_assets": null,
        "right_to_appoint_and_remove": null,
        "right_to_share_surplus_assets": null,
        "significant_influence_or_control": null,
        "voting_rights": "voting rights 25 to 50 percent"
      },
      {
        "relation_type": "individual-person-with-significant-control",
        "ident": "i3osGDj1oLQ97fXkhqysgZi7Opc",
        "full_name": "Mr Stephen John Davies",
        "first_name": "Stephen",
        "middle_name": "John",
        "last_name": "Davies",
        "pre_title": "Mr",
        "nationality": "British",
        "country_residence": null,
        "main_address_line_1": "Rushmills",
        "main_address_line_2": null,
        "main_address_locality": "Northampton",
        "main_address_postcode": "NN4 7YB",
        "main_address_country": "England",
        "main_address_premises": "1",
        "day_of_birth": null,
        "month_of_birth": "2",
        "year_of_birth": "1976",
        "etag": "221a41c8f5d3e158d18c63827e280003993ba1eb",
        "url_to_source": "/company/07394914/persons-with-significant-control/individual/i3osGDj1oLQ97fXkhqysgZi7Opc",
        "notified_on": null,
        "ownership_of_shares": null,
        "part_right_to_share_surplus_assets": null,
        "right_to_appoint_and_remove": null,
        "right_to_share_surplus_assets": null,
        "significant_influence_or_control": null,
        "voting_rights": "voting rights 25 to 50 percent"
      },
      {
        "relation_type": "individual-person-with-significant-control",
        "ident": "6bU8Cr-doISlRQmmtvdENYZzeLg",
        "full_name": "Mr Douglas James Scott",
        "first_name": "Douglas",
        "middle_name": "James",
        "last_name": "Scott",
        "pre_title": "Mr",
        "nationality": "Welsh",
        "country_residence": null,
        "main_address_line_1": "Rushmills",
        "main_address_line_2": null,
        "main_address_locality": "Northampton",
        "main_address_postcode": "NN4 7YB",
        "main_address_country": "England",
        "main_address_premises": "1",
        "day_of_birth": null,
        "month_of_birth": "3",
        "year_of_birth": "1960",
        "etag": "e3cadf2b983e1a165c46824dda9c28f91c2f21ea",
        "url_to_source": "/company/07394914/persons-with-significant-control/individual/6bU8Cr-doISlRQmmtvdENYZzeLg",
        "notified_on": null,
        "ownership_of_shares": null,
        "part_right_to_share_surplus_assets": null,
        "right_to_appoint_and_remove": null,
        "right_to_share_surplus_assets": null,
        "significant_influence_or_control": null,
        "voting_rights": "voting rights 25 to 50 percent"
      }
    ]
  },
  {
    "company_name": "NEW ABC CHIPPIE LIMITED",
    "company_number": "SC479958",
    "company_status": "active",
    "category": "ltd",
    "subcategory": null,
    "country_of_origin": "United Kingdom",
    "incorporation_date": "2014-06-12",
    "dissolution_date": null,
    "main_address_care_of": null,
    "main_address_pobox": null,
    "main_address_line_1": "22 Charlotte Dundas Court",
    "main_address_line_2": null,
    "main_address_post_town": "Grangemouth",
    "main_address_post_county": null,
    "main_address_post_country": "Scotland",
    "main_address_postcode": "FK3 9EA",
    "sic1": "56210",
    "sic2": null,
    "sic3": null,
    "sic4": null,
    "account_ref_day": "30",
    "account_ref_month": "06",
    "account_next_due": "2020-03-31",
    "account_last_made_up": "2018-06-30",
    "account_category": null,
    "returns_next_due": null,
    "returns_last_made_up": null,
    "insolvency_status": null,
    "etag": "d67b690da964248e17682c6a6439dc3e6fede9ef",
    "relations": [
      {
        "relation_type": "person",
        "ident": "3WLBRdgMJ11NNuXoriICVjxB8A0",
        "company_name": null,
        "first_name": "Pik Shan",
        "last_name": "FUNG",
        "role": "director",
        "nationality": "British",
        "country_residence": "Scotland",
        "occupation": "Fish And Chip Fast Food",
        "start_date": "2014-06-12",
        "end_date": null,
        "main_address_line_1": "Charlotte Dundas Court",
        "main_address_line_2": null,
        "main_address_locality": "Grangemouth",
        "main_address_postcode": "FK3 9EA",
        "main_address_region": null,
        "main_address_country": "Scotland",
        "main_address_premises": "22",
        "day_of_birth": null,
        "month_of_birth": "6",
        "year_of_birth": "1983"
      }
    ],
    "people_with_significant_control": [
      {
        "relation_type": "individual-person-with-significant-control",
        "ident": "AVBTSMG8yjH4XlrRZSqP4lGgvkA",
        "full_name": "Miss Pik Shan Fung",
        "first_name": "Pik",
        "middle_name": "Shan",
        "last_name": "Fung",
        "pre_title": "Miss",
        "nationality": "British",
        "country_residence": null,
        "main_address_line_1": "Charlotte Dundas Court",
        "main_address_line_2": null,
        "main_address_locality": "Grangemouth",
        "main_address_postcode": "FK3 9EA",
        "main_address_country": "Scotland",
        "main_address_premises": "22",
        "day_of_birth": null,
        "month_of_birth": "6",
        "year_of_birth": "1983",
        "etag": "a0802fe8f0d115a61f8787b0c46f924b702a3e8f",
        "url_to_source": "/company/SC479958/persons-with-significant-control/individual/AVBTSMG8yjH4XlrRZSqP4lGgvkA",
        "notified_on": null,
        "ownership_of_shares": "ownership of shares 75 to 100 percent",
        "part_right_to_share_surplus_assets": null,
        "right_to_appoint_and_remove": "right to appoint and remove directors",
        "right_to_share_surplus_assets": null,
        "significant_influence_or_control": "significant influence or control as firm",
        "voting_rights": "voting rights 75 to 100 percent"
      }
    ]
  },
]

A sample API response in case of no results:


[]

The method returns list of maximum 10 companies data rows from Transparent Data database, obtained from the company register of United Kingdom, Companies House (gov.uk).

Parameter

Name Obligatory Description Additional info
q YES search phrase -

Data

Main company fields:

Fields in the relations section:

Fields in the people_with_significant_control section:

Transparent Data API

Sample collection

download

Endpoint /add

Sample JSON

{
  "source": "ZRODLO_DANYCH",
  "method": "NAZWA_METODY",
  "params": {
    "PARAMETR": 1
  }
}

Authentication

Access to TD API resources requires authentication through the standard HTTP Basic Auth mechanisms.

A user receives credentials as follows:

Name Desc
user username
pass password required for authentication
key unique account id

All requests use SSL.

Request form

Name Obligatory Description
source YES data source name
method YES name of the data source method
params YES query parameters

Sample request:

curl --user:pass -d '{"source":"ZRODLO_DANYCH", "method":"NAZWA_METODY", "params" :{"PARAMETR":1} }' https://api.transparentdata.pl/key/add

Sample response:

{
  "status": "quened",
  "ident": "a4a69bb9-8619-4927-89c5-e03e30f69897"
}

Endpoint /result

Sample request:

curl --user:pass  https://api.transparentdata.pl/key/result?ident=a4a69bb9-8619-4927-89c5-e03e30f69897

Sample response when status queued:

{
  "status": "quened",
  "ident": "a4a69bb9-8619-4927-89c5-e03e30f69897"
}

Sample response when status done:

{
  "status": "done",
  "ident": "a4a69bb9-8619-4927-89c5-e03e30f69897",
  "data": [
    {
      "source": "ZRODLO_DANYCH",
      "method": "NAZWA_METODY",
      "params": {
        "PARAMETR": 1
      },
      "result": {
        "WYNIK": 123
      }
    }
  ]
}

Data Sources

TD - Sanction Lists JSON

Sample query

{  
   "source":"aml_sanction",
   "method":"check",
   "params":{  
      "name":"Jan Kowalski"
   }
}

Sample response

{
    "status": "quened",
    "ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
curl --user:pass  https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1

Sample dataset by calling method /result

"Jan Kowalski","Sprawdzono: brak wyników","Sprawdzono: brak wyników"

The source allows you to download information about the presence of a given natural person on 16 of the world's largest sanction lists in JSON format.

Country Name
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

In order to aggregate data, the request ID should be used.

TD - PEP JSON

Sample query

{
   "source":"pep",
   "method":"check",
   "params":{
      "name":"Andrzej Duda"
   }
}

Sample response

{
    "status": "quened",
    "ident": "fcb5ee35-5172-42d1-916b-c5fa442fabee"
}
curl --user:pass  https://api.transparentdata.pl/key/result?ident=fcb5ee35-5172-42d1-916b-c5fa442fabee

Sample dataset by calling method /result

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

The source allows you to download information on the presence of a given natural person in 9 databases of politically exposed persons (PEP) in the JSON format.

Data (name and surname, position, date of birth, term of office) are returned on the basis of the following PEP databases:

In order to aggregate data, the request ID should be used.

TD - UBO PL JSON

Sample query

{  
   "source":"beneficiary",
   "method":"getPl",
   "params":{  
      "nip":"123123123"
   }
}

The source allows you to download data about the ultimate beneficial owners of Polish companies in JSON format.
The information about UBO (name and surname, PESEL number and indication of the percentage of shares) comes from the related KRS (the National Court Register) and CEIDG (the Central Registration and Information on Business) and CRBR (Polish Central Register of Ultimate Beneficial Owners).

Request

Nr Field Description Variable format Allowed value categories Obligatory
1 source data source name string beneficiary YES
2 method name of the data source method for the copy of KRS json string getPl YES
3 params query parameters node YES
4 nip company tax identification number int 10-digit NIP number YES

In order to aggregate data, the request ID should be used.

Sample response

{
    "status": "quened",
    "ident": "63eb039d-9039-4e6c-a1a2-924e348c18c1"
}
curl --user:pass  https://api.transparentdata.pl/key/result?ident=63eb039d-9039-4e6c-a1a2-924e348c18c1

Response

Sample dataset by calling method /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"
                    }
                ]
            }
        }
    ]
}
Nr Field Description Variable format Allowed value categories Obligatory
1 status task execution status string done/quened/in_progress/error YES
2 ident unique identification number given during the query string YES
3 added date of query string date(format Y-m-d H:i:s) YES
4 finished date of execution string date(format Y-m-d H:i:s) YES
5 user_account user account name string/nullable text string/null YES
6 progress percentage of task completion int 0-100 YES
7 data an array with data array(array) YES
8 task_id individual id number assigned when creating the task int YES
9 source data source name string KRS/CRBR YES
10 method name of the data source method for the copy of KRS/CRBR json string data YES
11 params query parameters node YES
12 nip company tax identification number int 10-digit NIP number YES
13 meta meta tags string null YES
14 result result of query node YES
15 beneficiaries table with the list of beneficiaries array(array) YES
16 pesel national identification number of a natural person used in Poland int/empty number/empty string YES
17 percentage percentage values of shares in the company float number YES
18 name name and surname of UBO string/nullable text string / null YES