Search lets you query the Polish business registry and filter results to companies that actually have contact data. This guide shows you how to build effective queries and get the most out of the available filters.
The contact filter
The has_contact parameter is the most important filter in Search. It ensures every result has at least one verified contact — no empty records, no dead ends. You can filter by phone, email, fax, or any to accept all contact types.
Available filters
All filters are optional and combinable. The more filters you add, the more targeted your results.
| Parameter | Type | Description |
|---|---|---|
has_contact | enum | phone, email, fax, any |
activity_code | string | Exact PKD code. E.g. 62.01.Z |
activity_prefix | string | PKD prefix. E.g. 62 |
active_start_from | date | Registration date from. Y-m-d |
active_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 with phone numbers
Find companies registered in the last month in Mazowieckie with a phone number.
GET /api/v1/companies/search curl "https://alexambros.com/api/v1/companies/search?has_contact=phone&active_start_from=2026-02-01&active_start_to=2026-03-01&voivodeship=mazowieckie" \ -H "Authorization: Bearer sk_api_xxxx"
Example — IT companies by activity code
Find active IT companies by PKD prefix with an email address.
GET /api/v1/companies/search curl "https://alexambros.com/api/v1/companies/search?has_contact=email&activity_prefix=62&status=ACTIVE" \ -H "Authorization: Bearer sk_api_xxxx"
Example — companies in a specific city
Find companies in Warsaw with any contact type.
GET /api/v1/companies/search curl "https://alexambros.com/api/v1/companies/search?has_contact=any&city=Warszawa" \ -H "Authorization: Bearer sk_api_xxxx"
Pagination
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 Search request costs 20 credits regardless of how many results are returned. Plan your queries to get the most relevant results before paginating.