{
  "openapi": "3.0.1",
  "info": {
    "title": "Czech Insolvency Register ISIR - Bankruptcy Check & Monitor",
    "description": "Check Czech companies and individuals for insolvency in the official ISIR register. Lookups by company ID, personal ID or name, incremental monitoring of new events with watchlists and webhooks, case details. Normalized English output for KYC and compliance.",
    "version": "0.1",
    "x-build-id": "gV9G9ORnZuCdpxSxo"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/pringlesbitch~czech-insolvency-register-isir/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-pringlesbitch-czech-insolvency-register-isir",
        "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/pringlesbitch~czech-insolvency-register-isir/runs": {
      "post": {
        "operationId": "runs-sync-pringlesbitch-czech-insolvency-register-isir",
        "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/pringlesbitch~czech-insolvency-register-isir/run-sync": {
      "post": {
        "operationId": "run-sync-pringlesbitch-czech-insolvency-register-isir",
        "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",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "lookup",
              "monitor",
              "proceeding"
            ],
            "type": "string",
            "description": "<b>lookup</b> — check subjects for insolvency (by IČO, personal ID or name). <b>monitor</b> — incrementally emit new insolvency events since the last run (state persists between runs; use with a schedule). <b>proceeding</b> — resolve current state of specific insolvency cases by case number.",
            "default": "lookup"
          },
          "icos": {
            "title": "Company IDs (IČO)",
            "type": "array",
            "description": "Czech company identification numbers to check (8 digits, leading zeros allowed). Lookup mode.",
            "items": {
              "type": "string"
            }
          },
          "birthNumbers": {
            "title": "Personal IDs (rodné číslo)",
            "type": "array",
            "description": "Czech personal identification numbers, with or without slash. <b>Privacy:</b> personal IDs are never echoed to the output in plain text — only masked (YYMMDD/****) plus a SHA-256 hash for joining.",
            "items": {
              "type": "string"
            }
          },
          "names": {
            "title": "Names",
            "type": "array",
            "description": "Person surnames or company names to search for. Lookup mode. Name search can return multiple matches — combine with exactNameMatch.",
            "items": {
              "type": "string"
            }
          },
          "exactNameMatch": {
            "title": "Exact name match",
            "type": "boolean",
            "description": "Only return exact name matches (applies to name-based lookups).",
            "default": false
          },
          "ignoreDiacritics": {
            "title": "Ignore diacritics",
            "type": "boolean",
            "description": "Match names regardless of Czech diacritics (Novak = Novák).",
            "default": true
          },
          "activeOnly": {
            "title": "Active proceedings only",
            "type": "boolean",
            "description": "Only return currently active insolvency proceedings (skip closed/historical ones).",
            "default": false
          },
          "caseNumbers": {
            "title": "Case numbers",
            "type": "array",
            "description": "Insolvency case numbers to resolve, e.g. 'INS 12575/2022'. Proceeding mode.",
            "items": {
              "type": "string"
            }
          },
          "watchlistIcos": {
            "title": "Watchlist — company IDs",
            "type": "array",
            "description": "Monitor mode: only emit events whose debtor matches one of these IČOs. Leave empty (with empty watchlist personal IDs) to emit all new events.",
            "items": {
              "type": "string"
            }
          },
          "watchlistBirthNumbers": {
            "title": "Watchlist — personal IDs",
            "type": "array",
            "description": "Monitor mode: only emit events whose debtor matches one of these personal IDs (with or without slash).",
            "items": {
              "type": "string"
            }
          },
          "startFromId": {
            "title": "Start from event ID",
            "minimum": 0,
            "type": "integer",
            "description": "Monitor mode, first run only: start reading the registry log after this event ID. Leave empty to start from the current end of the log (recommended)."
          },
          "maxEvents": {
            "title": "Max events per run",
            "minimum": 1,
            "type": "integer",
            "description": "Monitor mode: stop after emitting this many events (cost protection).",
            "default": 1000
          },
          "maxItems": {
            "title": "Max subjects / cases per run",
            "minimum": 1,
            "type": "integer",
            "description": "Lookup & proceeding modes: cap on processed subjects or case numbers (cost protection).",
            "default": 100
          },
          "maxResultsPerSubject": {
            "title": "Max results per subject",
            "minimum": 1,
            "type": "integer",
            "description": "Cap on registry matches returned for a single subject (name searches can match many).",
            "default": 50
          },
          "maxBatches": {
            "title": "Max log batches per run",
            "minimum": 1,
            "type": "integer",
            "description": "Monitor mode: max registry log batches (1000 events each) scanned per run.",
            "default": 100
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "Monitor mode: POST a JSON notification here when new events were emitted."
          },
          "stateStoreName": {
            "title": "State store name",
            "type": "string",
            "description": "Named key-value store holding the monitor position between runs. Change to run multiple independent monitors.",
            "default": "cz-isir-state"
          },
          "stateSaveInterval": {
            "title": "State save interval",
            "minimum": 1,
            "type": "integer",
            "description": "How often (in emitted events) to persist monitor state. 1 = safest (at most one duplicate on crash), higher = fewer store writes.",
            "default": 1
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}