Company Search lets you query the Polish business registry and filter results by your own criteria - industry, location, status, or registration date. This guide shows you how to build precise queries and get the most out of the available filters.
Available filters
All filters are optional and combinable. The more filters you add, the more precise your results.
| Parameter | Type | Description |
|---|---|---|
activity_code | string | Exact PKD code. E.g. 6201Z |
activity_prefix | string | PKD prefix. E.g. 62 |
activity_start_from | date | Registration date from. Y-m-d |
activity_start_to | date | Registration date to. Y-m-d |
voivodeship | string | E.g. mazowieckie |
city | string | City name. |
postal_code | string | Postal code. |
status | enum | ACTIVE, SUSPENDED, DELETED |
legal_form | string | Legal form slug. |
page | integer | Page number. Default: 1. |
Example – new companies in Mazowieckie
Find companies registered in the last month in Mazowieckie.
GET /api/v1/companies/search curl "https://api.entiway.com/api/v1/companies/search?activity_start_from=2026-02-01&activity_start_to=2026-03-01&voivodeship=mazowieckie" \ -H "Authorization: Bearer sk_api_xxxx"
Example – active IT companies by activity code
Find active IT companies by PKD prefix.
GET /api/v1/companies/search curl "https://api.entiway.com/api/v1/companies/search?activity_prefix=62&status=ACTIVE" \ -H "Authorization: Bearer sk_api_xxxx"
Example – companies by postal code
Find active companies registered under a given postal code.
GET /api/v1/companies/search curl "https://api.entiway.com/api/v1/companies/search?postal_code=00-001&status=ACTIVE" \ -H "Authorization: Bearer sk_api_xxxx"
Pagination
Company Search returns 20 results per page. Use the page parameter to navigate. The response includes total, current_page, and last_page so you know how many results are available.
Credit cost
Each Company Search request costs 20 credits regardless of how many results are returned. Plan your queries to get the most relevant results before paginating.