{ "openapi": "3.0.1", "info": { "title": "Slovakia Financial Statements API & Filing Monitor", "description": "Slovakia financial statements scraper API for official RÚZ filings. Export full filing histories and structured report tables by IČO, consume incremental changes, or monitor up to 500 companies for new statements. No browser, proxy, login, or PDF parsing.", "version": "0.1", "x-build-id": "aitzUmvsz45dBELxW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automa-flow~slovakia-financial-statements-api-filing-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automa-flow-slovakia-financial-statements-api-filing-monitor", "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/automa-flow~slovakia-financial-statements-api-filing-monitor/runs": { "post": { "operationId": "runs-sync-automa-flow-slovakia-financial-statements-api-filing-monitor", "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/automa-flow~slovakia-financial-statements-api-filing-monitor/run-sync": { "post": { "operationId": "run-sync-automa-flow-slovakia-financial-statements-api-filing-monitor", "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": [ "company", "changes", "monitor" ], "type": "string", "description": "company returns full company histories; changes reads the official incremental feed; monitor compares a portfolio with its last successful snapshot. Fields that belong to another mode are rejected instead of silently ignored.", "default": "company" }, "icos": { "title": "Slovak IČOs", "minItems": 1, "maxItems": 500, "uniqueItems": true, "type": "array", "description": "One to 500 unique 8-digit Slovak IČOs with a valid checksum, for example 31333532. Required in company and monitor modes. An invalid row is returned as a non-billable FAILED result while the remaining IČOs continue. Must be empty in changes mode, where the official feed is global.", "items": { "type": "string", "pattern": "^[0-9]{8}$" } }, "stateKey": { "title": "Monitor state key", "pattern": "^[A-Za-z0-9._-]+$", "minLength": 1, "maxLength": 100, "type": "string", "description": "Required in monitor mode, rejected elsewhere. Separates independent portfolio baselines in a named Apify key-value store." }, "includeFinancialReports": { "title": "Include structured financial reports", "type": "boolean", "description": "Fetch and map report table values using official template metadata. Read in company and monitor modes; reported in RUN_SUMMARY.ignoredInputFields when set in changes mode.", "default": true }, "includeAnnualReports": { "title": "Include annual report metadata", "type": "boolean", "description": "Include public annual-report metadata and attachment descriptors. Files are not downloaded. Read in company and monitor modes.", "default": false }, "changedSince": { "title": "Changed since", "type": "string", "description": "Inclusive lower bound. A plain date such as 2026-08-27 is read as that day's UTC midnight; a full ISO-8601 timestamp must carry a timezone. Required in changes mode, rejected elsewhere." }, "entityTypes": { "title": "Change entity types", "uniqueItems": true, "type": "array", "description": "Official entity feeds to read. Defaults to accounting statements and financial reports when left empty.", "items": { "type": "string", "enum": [ "accountingUnits", "accountingStatements", "financialReports", "annualReports" ], "enumTitles": [ "Accounting units", "Accounting statements", "Financial reports", "Annual reports" ] } }, "maxResults": { "title": "Maximum change records", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Aggregate cap across all selected entity feeds. Defaults to 10000 when left empty." }, "continuationCursors": { "title": "Change feed continuation cursors", "type": "object", "description": "Optional cursors returned in RUN_SUMMARY.changeFeeds. Map a selected entity type to its nextCursor to continue an incomplete feed without replaying earlier IDs.", "default": {} }, "includeRaw": { "title": "Include raw source JSON", "type": "boolean", "description": "Adds official raw JSON to records. This increases dataset size and is usually unnecessary.", "default": false } } }, "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 } } } } } } } } } }