# Polish KRS Business Register Lookup

> Polish KRS Business Register Lookup is a paid API for AI agents from api.companyrecords-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Returns the current official extract for a Polish company from the KRS national court register, given a 10-digit KRS number.

## Facts

- Endpoint: GET https://api.companyrecords-api.workers.dev/api/gov/krs-poland?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polish-krs-business-register-lookup-8c9cbb8b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_f_YKg9PENawxd1xtjMB3i

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability polish-krs-business-register-lookup-8c9cbb8b
```

Example prompt: Can you pull the current KRS register extract for the Polish company with KRS number 0000500000 — I need its official name, legal form, NIP number, and registered address?

## When to prefer this

Use this endpoint when you have a specific 10-digit KRS number for a Polish legal entity and need authoritative, current official data directly from the Polish national court register. Prefer this over generic business search tools when you need the official NIP, legal form, and registered address for compliance, due diligence, or data enrichment purposes. Not suitable for searching by company name — a KRS number is required.

## Known failure modes

- KRS number not found or not registered returns HTTP 404
- Invalid KRS number format (not 10 digits) may return an error
- KRS API upstream unavailability may cause timeouts or 5xx errors
- Company in liquidation is still returned but name may reflect liquidation status

## How this service works

Pay-per-call company registry, government, legal and B2B data tools for AI agents, from official registers and public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

A JSON object containing the company's KRS number, NIP tax number, official name, legal form, registered seat city, full registered address (street, number, city, postcode), registration date, last entry date, extract state date, and the source URL from the Polish Ministry of Justice KRS API. Returns 404 if the KRS number is not found.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "krs"
     ],
     "properties": {
      "krs": {
       "type": "string",
       "description": "KRS number, 10 digits, e.g. 0000500000"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "krs": "0000500000",
  "nip": "5272711290",
  "name": "FUNDACJA ŚWIATOWEGO TYGODNIA PRZEDSIĘBIORCZOŚCI W LIKWIDACJI",
  "source": "https://api-krs.ms.gov.pl/api/krs/OdpisAktualny/0000500000",
  "address": {
   "city": "WARSZAWA",
   "number": "15",
   "street": "CHŁODNA",
   "postCode": "00-891"
  },
  "checkedAt": "2026-10-23T09:37:04.342Z",
  "legalForm": "FUNDACJA",
  "registeredOn": "10.03.2014",
  "lastEntryDate": "31.03.2026",
  "registeredSeat": "WARSZAWA",
  "extractStateDate": "31.03.2026"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polish-krs-business-register-lookup-8c9cbb8b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.companyrecords-api.workers.dev](https://www.zero.xyz/host/api.companyrecords-api.workers.dev/llms.txt)