{ "openapi": "3.0.1", "info": { "title": "Spanish Company Register Events (BORME)", "description": "New companies, capital changes, address and name changes, dissolutions and closures from Spain's official Commercial Register gazette (BORME), structured per company. Names of people are never returned.", "version": "0.1", "x-build-id": "itNlfqArXTEJHebFO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/viperthruster~borme-company-events/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-viperthruster-borme-company-events", "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/viperthruster~borme-company-events/runs": { "post": { "operationId": "runs-sync-viperthruster-borme-company-events", "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/viperthruster~borme-company-events/run-sync": { "post": { "operationId": "run-sync-viperthruster-borme-company-events", "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": [ "dates" ], "properties": { "dates": { "title": "Publication dates", "minItems": 1, "maxItems": 31, "type": "array", "description": "BORME publication dates as YYYY-MM-DD, or latest for the most recent one; up to 31. The BORME is published on working days; dates without one are skipped.", "items": { "type": "string", "pattern": "^(latest|\\d{4}-\\d{2}-\\d{2})$" } }, "provinces": { "title": "Provinces", "maxItems": 60, "type": "array", "description": "Spanish provinces as printed in the BORME, for example MADRID, BARCELONA, VALENCIA, MÁLAGA or BIZKAIA; up to 60. Accents and case do not matter. Leave empty for all provinces.", "items": { "type": "string" }, "default": [] }, "actTypes": { "title": "Event types", "type": "array", "description": "Return only companies with at least one of these events. Leave empty for all. Officer appointments and removals are reported as event types only: the names of people are never returned.", "items": { "type": "string", "enum": [ "constitution", "capital_increase", "capital_reduction", "address_change", "purpose_change", "name_change", "bylaws_change", "dissolution", "extinction", "merger", "split", "transformation", "sole_shareholder", "sole_shareholder_lost", "insolvency", "appointments", "reappointments", "dismissals", "revocations", "other" ], "enumTitles": [ "Constitution (new company)", "Capital increase", "Capital reduction", "Registered address change", "Corporate purpose change", "Company name change", "Bylaws amendment", "Dissolution", "Extinction (company closed)", "Merger", "Split (escisión)", "Change of legal form", "Became single-shareholder", "No longer single-shareholder", "Insolvency proceedings", "Officer appointments (names not returned)", "Officer re-elections (names not returned)", "Officer removals (names not returned)", "Powers of attorney revoked (names not returned)", "Other registered acts" ] }, "default": [] }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many companies in total, up to 10000. A busy day has about 2,000 announcements across Spain.", "default": 50 }, "monitorMode": { "title": "Only new announcements", "type": "boolean", "description": "Return only announcements not returned by a previous run with this option on. Useful for a daily schedule with dates set to latest.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed: the BOE open data API is public. Leave empty to connect directly." } } }, "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 } } } } } } } } } }