# Poland KRZ National Debtor Registry Scraper (`regdata/krz-debtor-scraper`) Actor

Automate bankruptcy and restructuring checks against the official public debtor registry. Nine search modes cover companies, persons, sole traders, case signatures, proceedings, shareholders, and assets. Build a credit-risk watchlist or insolvency workflow. Pay-per-result.

- **URL**: https://apify.com/regdata/krz-debtor-scraper.md
- **Developed by:** [getregdata](https://apify.com/regdata) (community)
- **Categories:** Business, Lead generation, Automation
- **Stats:** 12 total users, 8 monthly users, 99.9% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 search results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Poland KRZ National Debtor Registry Scraper | Krajowy Rejestr Zadluzonych

Check if a company or person has bankruptcy, restructuring, or enforcement proceedings in Poland's National Debtor Registry. No public API exists - this is the only programmatic access to KRZ data outside of commercial providers like MGBI.

### Quick Start

Click **Try it** and paste this input:

```json
{
  "searchMode": "entity",
  "entityName": "Getin"
}
````

### Sample Output

```json
{
  "entityName": "GETIN RENT SPOLKA Z OGRANICZONA ODPOWIEDZIALNOSCIA",
  "nip": "8992777278",
  "krs": "0000585174",
  "regon": null,
  "proceedingId": "96dd6ffc-191c-41ce-bcc4-998524e4efd2",
  "caseSignature": null,
  "proceedingType": null,
  "proceedingStatus": null,
  "court": null,
  "role": null,
  "searchType": "entity",
  "sourceUrl": "https://krz.ms.gov.pl/"
}
```

### Pricing

| Volume | Cost |
|--------|------|
| 1 result | $0.006 |
| 100 results | ~$0.63 |
| 1,000 results | ~$6.03 |
| 10,000 results | ~$60.03 |

Start cost per run: **$0.025**. Free Apify credits ($5) = ~833 results at no cost.

### Features

- **9 search modes** - entity, person, sole trader, case signature, proceeding details, announcements, shareholders, bankruptcy estate, advisors
- **No subscription** - pay-per-use alternative to MGBI/iMSiG ($200-500/month)
- **Structured JSON output** - from the government portal that has no public API
- **Hybrid Puppeteer + API** - browser for session only, then fast REST API calls
- **Batch screening** - check entire portfolios against the debtor registry
- **Announcements board** - access the full Tablica Obwieszczen

### Related Actors

- [Polish REGON Scraper](https://apify.com/regdata/polish-regon-scraper) - resolve any Polish company to its NIP, REGON and KRS number; the entry point to the suite
- [MSiG Court Gazette Scraper](https://apify.com/regdata/msig-scraper) - track bankruptcy and restructuring announcements from the official court gazette
- [CRBR Beneficial Owners Scraper](https://apify.com/regdata/crbr-beneficial-owners-scraper) - verify UBO declarations for KYC/AML compliance
- [KRS Financial Statements Scraper](https://apify.com/regdata/poland-krs-financial-scraper) - extract balance sheets and income statements from eKRS

### Input Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `searchMode` | string | No | `entity` | Search type (see modes below) |
| `entityName` | string | No | - | Company name, business name, or advisor surname |
| `identifier` | string | No | - | KRS, NIP, REGON, PESEL, or license number |
| `caseSignature` | string | No | - | Case signature (CODE/REPERTORY/NUMBER/YEAR) |
| `proceedingId` | string | No | - | Proceeding UUID (from prior search result) |
| `estateType` | string | No | - | Asset type filter for bankruptcyEstate mode |
| `advisorCity` | string | No | - | City filter for advisors mode |
| `dateFrom` | string | No | - | Date range start (YYYY-MM-DD), for announcements |
| `dateTo` | string | No | - | Date range end (YYYY-MM-DD), for announcements |
| `maxResults` | integer | No | 100 | Max results (0 = unlimited) |
| `proxyConfiguration` | object | No | - | Apify Proxy config (residential PL recommended) |

#### Search Modes

| Mode | Searches For | Required Input |
|------|-------------|----------------|
| `entity` | Companies/organizations with proceedings | `entityName` and/or `identifier` (KRS/NIP/REGON) |
| `person` | Natural persons with proceedings | `identifier` (PESEL or NIP) |
| `soleTrader` | Sole traders (JDG) with proceedings | `entityName` and/or `identifier` |
| `signature` | Proceedings by court case signature | `caseSignature` |
| `proceedingDetails` | Full details of a specific proceeding | `proceedingId` (UUID from a prior search) |
| `announcements` | Court announcements and notices | `entityName`/`identifier` + `dateFrom`/`dateTo`, or `caseSignature` |
| `shareholders` | Partners in personal companies | `identifier` (KRS/NIP) or `entityName` |
| `bankruptcyEstate` | Assets for sale from bankruptcy estates | `entityName` and/or `identifier`, optional `estateType` |
| `advisors` | Licensed restructuring advisors | `entityName` (surname), `identifier` (license #), or `advisorCity` |

### Output Fields

| Field | Description |
|-------|-------------|
| `entityName` | Company or person name |
| `nip` | Polish Tax ID |
| `krs` | KRS registration number |
| `regon` | REGON statistical number |
| `proceedingId` | UUID for fetching proceeding details |
| `caseSignature` | Court case signature |
| `proceedingType` | Type of proceeding (bankruptcy, restructuring, etc.) |
| `proceedingStatus` | Current status of the proceeding |
| `court` | Court handling the case |
| `role` | Entity's role in the proceeding |
| `searchType` | Search mode used |
| `sourceUrl` | Source registry URL |

### Use Cases

- **Credit Risk** - check if customers, suppliers, or partners have bankruptcy/restructuring proceedings
- **Debt Collection** - verify debtor status before pursuing claims
- **KYC/AML Compliance** - screen entities against the debtor registry
- **Due Diligence** - check target companies for insolvency proceedings
- **Legal Research** - find court announcements and case details
- **Bulk Screening** - batch checks against KRZ for entire portfolios

### Data Source & Compliance

- **Portal**: https://krz.ms.gov.pl/
- **Operator**: Ministry of Justice (Ministerstwo Sprawiedliwosci)
- **Legal basis**: Ustawa z dnia 6 grudnia 2018 r. o Krajowym Rejestrze Zadluzonych
- **Data since**: December 1, 2021
- **Coverage**: All bankruptcy, restructuring, and enforcement proceedings in Poland
- **Privacy**: PESEL numbers are NOT collected for privacy compliance

### Polish Business Data Suite

This actor is part of the **Polish Business Data Suite** - 8 active actors covering the full Polish company intelligence stack. No subscriptions, no minimum commitment - pay only for what you use.

| Registry | Actor | What it does |
|----------|-------|-------------|
| **eKRS** | [Financial Statements](https://apify.com/regdata/poland-krs-financial-scraper) | Balance sheets, income statements |
| **KRS** | [Board Members](https://apify.com/regdata/krs-fullnames-scraper) | Full non-anonymized director names |
| **KRZ** | [Debtor Registry](https://apify.com/regdata/krz-debtor-scraper) | Bankruptcy, restructuring, enforcement |
| **KNF** | [Financial Supervision](https://apify.com/regdata/knf-registry-scraper) | 75,000+ regulated financial entities |
| **MSiG** | [Court Gazette](https://apify.com/regdata/msig-scraper) | Court announcements since 2001 |
| **EKW** | [Land Registry](https://apify.com/regdata/ekw-ksiegi-wieczyste-scraper) | Ksiegi Wieczyste - ownership, mortgages, encumbrances |
| **CRBR** | [Beneficial Owners](https://apify.com/regdata/crbr-beneficial-owners-scraper) | UBO verification by NIP/KRS |
| **UOKiK** | [Abusive Clauses](https://apify.com/regdata/uokik-clauses-scraper) | 7,500+ banned contract clauses |
| **BDO** | [Waste Registry](https://apify.com/regdata/bdo-waste-registry-scraper) | 674,000+ waste management entities |
| **Sejm** | [Parliamentary PEP](https://apify.com/regdata/poland-parliamentary-pep-scraper) | Polish PEP list for KYC/AML screening |

> **Full suite**: [apify.com/regdata](https://apify.com/regdata)

> **Latest additions:** [Germany Handelsregister](https://apify.com/regdata/germany-handelsregister-scraper) - German company data, officers & capital · [Poland Parliamentary PEP](https://apify.com/regdata/poland-parliamentary-pep-scraper) - Polish Sejm PEP list for KYC/AML screening.

### Informacje po polsku

#### Czym jest ten aktor?

Ten aktor umozliwia automatyczne **sprawdzenie dluznika** w **Krajowym Rejestrze Zadluzonych** (KRZ) - oficjalnym rejestrze dluznikow prowadzonym przez Ministerstwo Sprawiedliwosci. KRZ nie udostepnia publicznego API, a jedyna alternatywa do tej pory byly reczne wyszukiwania na portalu krz.ms.gov.pl lub platne subskrypcje u dostawcow takich jak MGBI czy iMSiG. Ten aktor stanowi **alternatywe dla MGBI** - placisz wylacznie za faktyczne uzycie, bez abonamentu i bez umowy.

#### Dla kogo?

Narzedzie jest przeznaczone przede wszystkim dla **firm windykacyjnych** przeprowadzajacych weryfikacje kontrahenta przed wszczeciem postepowania egzekucyjnego, **dzialow ryzyka kredytowego** monitorujacych wyplacalnosc klientow i dostawcow, **kancelarii prawnych** obslugujacych sprawy z zakresu upadlosci i restrukturyzacji, oraz **dzialow compliance** realizujacych procedury KYC/AML.

#### Co mozna sprawdzic?

Aktor obsluguje pelne przeszukiwanie KRZ: wyszukiwanie podmiotow i osob fizycznych z postepowaniami upadlosciowymi lub restrukturyzacyjnymi, przegladanie tablicy obwieszczen, sprawdzanie masy upadlosci, wyszukiwanie doradcow restrukturyzacyjnych oraz wspolnikow spolek osobowych. Wystarczy podac nazwe firmy, NIP, KRS, REGON lub sygnature sprawy - wyniki zwracane sa jako ustrukturyzowany JSON.

#### Jak zaczac?

Uruchom aktora na platformie Apify, podajac dane podmiotu do weryfikacji. Mozesz tez zintegrowac go ze swoim systemem przez Apify API i uruchamiac automatyczne sprawdzenia dluznikow dla calego portfela. W porownaniu z MGBI i Transparent Data - brak subskrypcji, brak minimalnych oplat, rozliczenie wylacznie za zuzyte zasoby obliczeniowe.

### Limitations

- Session must be re-established for each actor run (JWT expiration)
- Results are limited to 250 per search query (KRZ server limit)
- Processing time: ~15s for session + ~1s per query
- Some entity types may have different response structures

***

### Krajowy Rejestr Zadluzonych - wyszukiwanie dluznikow online

Przeszukiwanie Krajowego Rejestru Zadluzonych (KRZ) pod katem upadlosci, restrukturyzacji i postepowań egzekucyjnych. 9 trybow wyszukiwania. Jedyny programistyczny dostep - portal rzadowy nie udostepnia API. Alternatywa dla MGBI bez abonamentu. Niezbedne narzedzie KYC/AML do weryfikacji kontrahentow.

# Actor input Schema

## `searchMode` (type: `string`):

What to search for. 'entity' = companies by name/KRS/NIP. 'person' = natural persons by PESEL/NIP. 'soleTrader' = sole traders by name/identifier. 'signature' = by court case signature. 'announcements' = court announcements. 'shareholders' = partners in personal companies. 'bankruptcyEstate' = assets for sale from bankruptcy estates. 'advisors' = licensed restructuring advisors. 'proceedingDetails' = deep-dive into a specific proceeding.

## `entityName` (type: `string`):

Company name, business name, or advisor surname (partial match). Used for entity, soleTrader, announcements, shareholders, bankruptcyEstate, and advisors modes.

## `identifier` (type: `string`):

Entity identifier: KRS (10 digits), NIP, REGON. For persons: PESEL or NIP. For advisors: license number.

## `caseSignature` (type: `string`):

Court case signature in format: CODE/REPERTORY/NUMBER/YEAR (e.g., WA1M/GU/223/2021). Used for signature and announcements modes.

## `proceedingId` (type: `string`):

Internal proceeding UUID (from a previous entity/person search result). Used for proceedingDetails mode to get full case info.

## `estateType` (type: `string`):

Filter bankruptcy estate by asset type. Only used in bankruptcyEstate mode.

## `advisorCity` (type: `string`):

Filter restructuring advisors by city. Only used in advisors mode.

## `dateFrom` (type: `string`):

Start date for announcement search (YYYY-MM-DD). Only used in announcements mode.

## `dateTo` (type: `string`):

End date for announcement search (YYYY-MM-DD). Only used in announcements mode.

## `maxResults` (type: `integer`):

Maximum number of results to return. Default: 100. Set to 0 for unlimited.

## `disableSessionCache` (type: `boolean`):

Advanced. By default the actor caches the portal session (Incapsula cookies + token) between your own runs so repeated/monitoring runs skip the slow browser bootstrap, run faster, and use less proxy bandwidth. The cache is private to your account and self-healing (a stale session is detected and refreshed automatically). Turn this on only to force a fresh session every run for debugging.

## `proxyConfiguration` (type: `object`):

Required. KRZ is behind an Incapsula WAF that blocks datacenter IPs and direct connections, so a residential or 4G proxy is needed. Apify Residential (PL) is used by default and works on PAID plans (any group you pick is forced to RESIDENTIAL). FREE plans do not include Residential proxy: in that case paste your own Polish residential/4G proxy under 'Custom proxies' - it works on any plan. If neither is available the run ends with a clear message instead of failing.

## Actor input object example

```json
{
  "searchMode": "entity",
  "entityName": "Getin",
  "estateType": "",
  "maxResults": 100,
  "disableSessionCache": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "PL"
  }
}
```

# Actor output Schema

## `searchResults` (type: `string`):

Debtor registry results with entity name, NIP, KRS, case signature, proceeding type, court, and status. Varies by search mode.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "entityName": "Getin",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "PL"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("regdata/krz-debtor-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "entityName": "Getin",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "PL",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("regdata/krz-debtor-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "entityName": "Getin",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "PL"
  }
}' |
apify call regdata/krz-debtor-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=regdata/krz-debtor-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Poland KRZ National Debtor Registry Scraper",
        "description": "Automate bankruptcy and restructuring checks against the official public debtor registry. Nine search modes cover companies, persons, sole traders, case signatures, proceedings, shareholders, and assets. Build a credit-risk watchlist or insolvency workflow. Pay-per-result.",
        "version": "1.0",
        "x-build-id": "O8V7tr7jn4CaWOvtn"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/regdata~krz-debtor-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-regdata-krz-debtor-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/regdata~krz-debtor-scraper/runs": {
            "post": {
                "operationId": "runs-sync-regdata-krz-debtor-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/regdata~krz-debtor-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-regdata-krz-debtor-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "searchMode": {
                        "title": "Search Mode",
                        "enum": [
                            "entity",
                            "person",
                            "soleTrader",
                            "signature",
                            "announcements",
                            "shareholders",
                            "bankruptcyEstate",
                            "advisors",
                            "proceedingDetails"
                        ],
                        "type": "string",
                        "description": "What to search for. 'entity' = companies by name/KRS/NIP. 'person' = natural persons by PESEL/NIP. 'soleTrader' = sole traders by name/identifier. 'signature' = by court case signature. 'announcements' = court announcements. 'shareholders' = partners in personal companies. 'bankruptcyEstate' = assets for sale from bankruptcy estates. 'advisors' = licensed restructuring advisors. 'proceedingDetails' = deep-dive into a specific proceeding.",
                        "default": "entity"
                    },
                    "entityName": {
                        "title": "Entity/Company Name",
                        "type": "string",
                        "description": "Company name, business name, or advisor surname (partial match). Used for entity, soleTrader, announcements, shareholders, bankruptcyEstate, and advisors modes."
                    },
                    "identifier": {
                        "title": "Identifier (KRS/NIP/REGON/PESEL)",
                        "type": "string",
                        "description": "Entity identifier: KRS (10 digits), NIP, REGON. For persons: PESEL or NIP. For advisors: license number."
                    },
                    "caseSignature": {
                        "title": "Case Signature (Sygnatura)",
                        "type": "string",
                        "description": "Court case signature in format: CODE/REPERTORY/NUMBER/YEAR (e.g., WA1M/GU/223/2021). Used for signature and announcements modes."
                    },
                    "proceedingId": {
                        "title": "Proceeding ID",
                        "type": "string",
                        "description": "Internal proceeding UUID (from a previous entity/person search result). Used for proceedingDetails mode to get full case info."
                    },
                    "estateType": {
                        "title": "Estate Asset Type",
                        "enum": [
                            "",
                            "nieruchomosc",
                            "ruchomosc",
                            "prawo-majatkowe",
                            "naleznosc",
                            "srodek-pieniezny"
                        ],
                        "type": "string",
                        "description": "Filter bankruptcy estate by asset type. Only used in bankruptcyEstate mode.",
                        "default": ""
                    },
                    "advisorCity": {
                        "title": "Advisor City",
                        "type": "string",
                        "description": "Filter restructuring advisors by city. Only used in advisors mode."
                    },
                    "dateFrom": {
                        "title": "Date From",
                        "type": "string",
                        "description": "Start date for announcement search (YYYY-MM-DD). Only used in announcements mode."
                    },
                    "dateTo": {
                        "title": "Date To",
                        "type": "string",
                        "description": "End date for announcement search (YYYY-MM-DD). Only used in announcements mode."
                    },
                    "maxResults": {
                        "title": "Max Results",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of results to return. Default: 100. Set to 0 for unlimited.",
                        "default": 100
                    },
                    "disableSessionCache": {
                        "title": "Disable session cache (advanced)",
                        "type": "boolean",
                        "description": "Advanced. By default the actor caches the portal session (Incapsula cookies + token) between your own runs so repeated/monitoring runs skip the slow browser bootstrap, run faster, and use less proxy bandwidth. The cache is private to your account and self-healing (a stale session is detected and refreshed automatically). Turn this on only to force a fresh session every run for debugging.",
                        "default": false
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Required. KRZ is behind an Incapsula WAF that blocks datacenter IPs and direct connections, so a residential or 4G proxy is needed. Apify Residential (PL) is used by default and works on PAID plans (any group you pick is forced to RESIDENTIAL). FREE plans do not include Residential proxy: in that case paste your own Polish residential/4G proxy under 'Custom proxies' - it works on any plan. If neither is available the run ends with a clear message instead of failing.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ],
                            "apifyProxyCountry": "PL"
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
