API Changelog

2023-05-16 New endpoint for custom tags

We have added new endpoint containing the list of tags assigned to companies by users from your company. See API docs for more details.

2022-08-22 Added param include_historic to suggest endpoint

For use together with name to search also in historic names of companies.

2022-06-30 Added sk_insolvency_cases to Company

We have added sk_insolvency_cases field to Company endpoint, see API docs for more details.

2022-04-22 Added param expand_regno to suggest endpoint

When used with regno param, the endpoint will return companies whose regnos start with given regno string. Max 2 more digits will be added to given regno, because usually there would be too many results for more digits.

2022-03-14 Added last_financial_statement field to Company

We have added last_financial_statement field to Company endpoint, see API docs for more details.

2021-12-15 Separate endpoint for company business licenses

We have created a new endpoint for the list of company business licenses (zivnosti): /company/licenses/. Check API docs for more details.

2021-11-23 Added closing_date field to Company

We have added closing_date field to Company endpoint, see API docs for more details.

2021-08-06 Added acting_manner field to Company

We have added acting_manner field to Company endpoint, see API docs for more details.

2021-04-12 Separate endpoint for company government contracts

We have created new endpoint for the list of company government contracts: /company/gov-contracts/. These data have been available directly on the /company/ endpoint until now, but as they are growing, sometimes they make the response on the general endpoint very large. Therefore we are moving them to separate endpoint and will remove them from the /company/ endpoint soon. The structure of contracts data remains the same.

2021-02-15 status field added to Suggest endpoint

Company status field has been added to SuggestSerializer. See API docs for details.

2020-09-03 Added company_index (rating) field to Company

We have added company_index field to Company endpoint. This index can be converted to company rating (A-Fx), see API docs for more details.

2020-08-25 Additions to Company and Suggest endpoints

We have added two new fields: regno_str containing company regno as 8-character string (with leading zeros) and address.lines consisting of 2-3 address lines according to Czech law 359/2011 Sb.

2020-05-12 New endpoints for company financial data

We have added two new endpoints providing financial data of CZ companies: /company/cz-financial-statements/ and /company/cz-financial-indicators/. These new endpoints will replace current financial data endpoints (/company/financial-statements/ and /company/financial-indicators/). For more details and new structure of data see API docs: financial statements and indicators.

2020-04-28 Added search by bank account number to Suggest endpoint

Account number can be provided as IBAN or in Czech format. See API docs for details.

2019-10-15 insolvency_cases field added to Suggest endpoint

Field insolvency_cases has been added to SuggestSerializer. See API docs for details.

2019-06-28 vzp_debt field in Company is not used for Czech subjects

Field vzp_debt returns null for Czech companies.

2019-06-05 add vat_registration_date field in Company

We have added vat_registration_date field to Company. Check API docs for more details.

2017-11-24 fixed empty databox_id field in Company

We have fixed always empty databox_id field in Company. You can now find ALL databox ids in new field databox_ids. Sorry for any inconvenience caused. Check API docs for more details.

2017-11-02 added address and company_role_id to Company.body.persons

We have added address and company_role_id fields to Person represenation. Check API docs for more details.

2017-11-01 fixed lat and lon properties

We have fixed GPS values which were set as lat={lon_value} and lon={lat_value} so far. We're sorry for any inconvenience caused.

2017-10-18 Added Company.government_grants

We have added local government grants to Company serializer (as government_grants). Check API docs for more details.

2017-10-13 Depracated sets removed

We have remove depracated sets/regnoset/{pk} and sets/saved-search/{pk} endpoints. Please use sets/regnoset/{pk}/regnos and sets/saved-search/{pk}/regnos to get regnos contained within wanted sets and use Company enpoints to get information you need.

Check sets and searches API docs for more details.

2017-10-13 contact _scored fields removed from Company

We removed previously added phones_scored, mobiles_scored, emails_scored and webs_scored fields. phones, mobiles, emai;s and webs fields now contain contact score.

Check API docs for more details.

2017-10-06 Company events endpoint added

We have added brand new endpoint events which you can query for czech companies events (f.e. company body, name, address changes, new goverment contracts and much more) within given period. You can also limit the query by providing specific regno.

Check API docs for more details.

2017-08-25 GovContract serialization changes

We have removed all price related fields (price_vat, price, price_foreign_currency) and replaced them with a single field called price_with_vat which represents contract price in CZK including VAT. gov_name and gov_regno fields have been renamed to payer_name and payer_regno respectively.

Check API docs for more details.

2017-08-09 Added company/business-premises endpoint

We added new endpoint which allows you to get all data about company business premises (provozovny). Check API docs for more details.

2017-08-07 Added sets/regnoset/{pk}/regnos and sets/saved-search/{pk}/regnos

We added two new endpoints which allow you to get regnos out of your saved sets and searches. You can use these regnos to fetch more detailed company information via company endpoints. This two endpoints will soon replace currently deprecated sets/regnoset/{pk} and sets/saved-search/{pk} endpoints. Check both sets and searches API docs for more details.

2017-08-03 Added scored phones, mobiles, webs & emails fields

We added four new contact fields (phones_scored, mobiles_scored, webs_scored and emails_scored) mimicking present phones, mobiles, webs and emails fields but containing also a score field. Score determines contact quality. A stands for best, C for worst. Check API docs for more details.

2017-06-26 Added option to sort results in Suggest endpoint

You can now optionally sort name suggestion results by name, turnover, turnover and name or "magic". Check API docs for more details.

2017-04-25 Added option to filter just active companies in Suggest endpoint

You can now optionally suggest only active companies. Check API docs for more details.

2017-04-25 Added Vokativ endpoint

You can use it to get vokativ for given first, last or both names. It also returns detected sex (male, female). Check API docs for more details.

2017-04-03 More filters for Company & Person relations

Added more filtering options for Company and Person queries. You can now filter on relation start/end date, share amount and company role.

2017-03-30 Relations endpoint added

You can now use our new Relations endpoint to query Company and Person relations. Results can be used to construct directed graphs of Company structure. Check API docs for more details.

2016-12-19 Social media added to companies

We have added Twitter, Facebook and LinkedIn profile links cz companies (if available). Check API docs for more details.

2016-12-12 GPS coords for companies added

We have added GPS coordinates for cz companies (if available). Check API docs for more details.

2016-12-12 companies can be queried by vatno

You can also query companies by vatno. Check API docs for more details.

2016-12-05 databox_id added

We have added databox id (datová schránka) to cz companies. Check API docs for more details.

2016-12-02 insolvency cases added

We have added insolvency cases filed against cz companies. Check API docs for more details.

2016-11-07 added banks and country_codes to Enums

Check API docs for more details.

2016-11-07 added European grants, trademarks and goverment contracts data for companies

Several more fields were added into Company Serializer:

Check API docs for more details.

2016-11-01 added company/financial-indicators endpoint

We have added some economic indicators based on financial statements.

2016-09-13 added salutation for Company objects

We have added salutation field to Company serialiazer. This is vokativ for company name (where available).

2016-09-02 more financial statement data added into in company/financial-statements endpoint

Financial statements endpoint now contains all data from "Rozvaha" and "Výkaz zisků a ztrát" (if available).

2016-09-02 company/economic_indicators moved to company/financial-statements

company/economic_indicators was moved to company/financial-statements

2016-08-12 added vzp_debt to Company

We have added vzp_debt field containing current owed sum to VZP (biggest czech/slovak health insurance company) to Company Serializer.

2016-06-09 added company/new endpoint

We have added new endpoint you can use to check for newly established companies withing given period.

2016-05-05 added embed endpoint

We have added embed endpoint you can use for embedding company or person information into your system using IFRAME. Feel free to check API docs for more details.

2016-03-22 added VAT information for sk companies

Several fields were added into Company Serializer. These take effect on SK datasets. Check is_vatpayer, vat_registration_type and taxno in API docs for more details.

2016-03-08 added sets/regnoset endpoint

You can list your saved regnosets using sets/regnoset and get companies from such sets at sets/regnoset/{pk}.

2016-03-07 fixed results count for sets/saved-search/{pk}

saved-search/{pk} endpoint should now return all companies (paginated by 100) found in given saved search instead of just first 10. We apologize for any inconvenience.

2016-03-03 added company/updates endpoint

We have added new endpoint you can use to check updated companies withing given period.

2016-01-20 region and county added into AddressSerializer

We have added another address information into AddressSerializer. Both region an county return both id and text representation.

2016-01-17 msgpack support added

From now on you consume our API data also in msgpack format. Use Accept: application/msgpack header or GET param format=msgpack to benefit from it.