{
  "openapi": "3.0.1",
  "info": {
    "title": "Czech New Companies & Liquidation Feed (ARES, daily)",
    "description": "New Czech companies (s.r.o., a.s., družstvo) from the official ARES daily change batches, plus liquidation, insolvency and deletion events. IČO, court file, share capital, region, activities. Filters and 'new since last run' mode.",
    "version": "0.1",
    "x-build-id": "yP3fY2IsR0gOZauJz"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/moment-data~czech-ares-new-companies-feed/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-moment-data-czech-ares-new-companies-feed",
        "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/moment-data~czech-ares-new-companies-feed/runs": {
      "post": {
        "operationId": "runs-sync-moment-data-czech-ares-new-companies-feed",
        "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/moment-data~czech-ares-new-companies-feed/run-sync": {
      "post": {
        "operationId": "run-sync-moment-data-czech-ares-new-companies-feed",
        "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": {
          "mode": {
            "title": "Mode",
            "enum": [
              "window",
              "sinceLastRun"
            ],
            "type": "string",
            "description": "window (default): events from the latest ARES change batch(es), no saved state. sinceLastRun: only batches released after the previous run for this State key, with de-duplication; use for daily schedules.",
            "default": "window"
          },
          "eventTypes": {
            "title": "Event types",
            "type": "array",
            "description": "registration = newly entered in the Public Register. liquidation = name changed to '... v likvidaci'. insolvency = insolvency proceedings entered in the register. deletion = struck off (with reason category).",
            "items": {
              "type": "string",
              "enum": [
                "registration",
                "liquidation",
                "insolvency",
                "deletion"
              ],
              "enumTitles": [
                "New company",
                "Entered liquidation",
                "Insolvency proceedings",
                "Deleted / struck off"
              ]
            },
            "default": [
              "registration"
            ]
          },
          "batches": {
            "title": "Batches (window mode)",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "How many of the newest daily ARES change batches to read. Roughly one batch per working day.",
            "default": 1
          },
          "autoWiden": {
            "title": "Auto-widen",
            "type": "boolean",
            "description": "Window mode: read up to 5 older batches if Max items is not reached.",
            "default": true
          },
          "lookbackDays": {
            "title": "Event lookback (days)",
            "minimum": 0,
            "maximum": 60,
            "type": "integer",
            "description": "An event counts if its register date is at most this many days before the batch release date (filters out re-indexed old entities).",
            "default": 14
          },
          "legalForms": {
            "title": "Legal forms",
            "type": "array",
            "description": "Optional. Groups: llc, jsc, cooperative, branch, partnership, nonprofit, foundation, housing; abbreviations sro, as, se, druzstvo, vos, ks, zs, ops; or ARES codes like 112, 121, 205. Overrides the include switches below.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "includeNonProfits": {
            "title": "Include associations & foundations",
            "type": "boolean",
            "description": "Spolky (z.s.), o.p.s., ústavy, nadace, trade unions. Excluded by default (B2B focus).",
            "default": false
          },
          "includePartnerships": {
            "title": "Include partnerships",
            "type": "boolean",
            "description": "v.o.s. and k.s. are usually named after the partners, so they are excluded by default.",
            "default": false
          },
          "includeHousingAssociations": {
            "title": "Include owners associations (SVJ)",
            "type": "boolean",
            "description": "Společenství vlastníků jednotek are named after a street address, so they are excluded by default.",
            "default": false
          },
          "regions": {
            "title": "Regions / cities",
            "type": "array",
            "description": "Match kraj, okres, municipality or municipality part, e.g. Praha, Jihomoravský kraj, Brno, Ostrava (diacritics optional).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "nameKeywords": {
            "title": "Name contains",
            "type": "array",
            "description": "Any of these words in the company name, e.g. invest, gastro, energy.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "activityKeywords": {
            "title": "Activity contains",
            "type": "array",
            "description": "Any of these words in the registered business activities (předmět podnikání), e.g. stavební, nemovitost, software.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "minShareCapital": {
            "title": "Min share capital (CZK)",
            "minimum": 0,
            "type": "integer",
            "description": "Only entities with registered share capital at least this amount."
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Maximum records per run (each record is one charged event).",
            "default": 30
          },
          "maxScan": {
            "title": "Max updated entities to scan",
            "minimum": 100,
            "maximum": 50000,
            "type": "integer",
            "description": "Cap on updated entities read per run for liquidation / insolvency / deletion events (about 100 per API call). A busy day has 1,000-6,000 updates.",
            "default": 3000
          },
          "enrich": {
            "title": "Add NACE codes and VAT ID",
            "type": "boolean",
            "description": "One extra bulk ARES call per 100 records. Brand-new companies usually get NACE / DIČ a few days after registration.",
            "default": true
          },
          "stateKey": {
            "title": "State key",
            "type": "string",
            "description": "Separate saved state per saved search in sinceLastRun mode.",
            "default": "default"
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}