{
  "openapi": "3.0.1",
  "info": {
    "title": "Spain BORME Feed: New Companies, Dissolutions, Insolvency",
    "description": "Daily feed of Spanish company acts from the official BORME (Registro Mercantil): new companies, dissolutions, extinctions, mergers, capital, name and address changes, insolvency (concurso). Province, event, legal form and keyword filters. Companies only, no person names. No API key.",
    "version": "0.1",
    "x-build-id": "BiyokGXZzqhE8e38f"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/moment-data~spain-borme-company-acts-feed/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-moment-data-spain-borme-company-acts-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~spain-borme-company-acts-feed/runs": {
      "post": {
        "operationId": "runs-sync-moment-data-spain-borme-company-acts-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~spain-borme-company-acts-feed/run-sync": {
      "post": {
        "operationId": "run-sync-moment-data-spain-borme-company-acts-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": {
          "eventTypes": {
            "title": "Event types",
            "type": "array",
            "description": "Keep company acts that contain at least one of these events. Default: constitution (new companies). Clear the list to get every act. officerChange = board/administrator appointments and removals (only counts and role labels are returned, never names).",
            "items": {
              "type": "string",
              "enum": [
                "constitution",
                "dissolution",
                "extinction",
                "merger",
                "demerger",
                "transformation",
                "capitalIncrease",
                "capitalReduction",
                "addressChange",
                "nameChange",
                "purposeChange",
                "insolvency",
                "registryClosure",
                "reopening",
                "uncollectibleCredit",
                "soleShareholderChange",
                "officerChange",
                "bylawsChange",
                "website",
                "bondIssue",
                "branch",
                "correction",
                "other"
              ],
              "enumTitles": [
                "New company (Constitución)",
                "Dissolution (Disolución)",
                "Extinction / struck off (Extinción)",
                "Merger (Fusión)",
                "Demerger / spin-off (Escisión, Segregación)",
                "Change of legal form (Transformación)",
                "Capital increase",
                "Capital reduction",
                "Registered office move (Cambio de domicilio)",
                "Name change (Cambio de denominación)",
                "Business purpose change (Objeto social)",
                "Insolvency (Situación concursal)",
                "Registry sheet closed (Cierre de hoja)",
                "Registry sheet reopened / reactivation",
                "Uncollectible credit (Crédito incobrable)",
                "Sole-shareholder status change (Unipersonalidad)",
                "Officer appointments/removals (counts only)",
                "Bylaws amendment",
                "Corporate website registered",
                "Bond issue",
                "Branch opened/closed",
                "Correction (Fe de erratas)",
                "Other (Otros conceptos)"
              ]
            },
            "default": [
              "constitution"
            ]
          },
          "provinces": {
            "title": "Provinces",
            "type": "array",
            "description": "Registro Mercantil provinces, by name (Madrid, Barcelona, Valencia, Málaga, Alicante, Bizkaia...) or 2-digit INE code (28, 08, 46, 29, 03, 48). Accent-insensitive. Empty = all of Spain.",
            "items": {
              "type": "string"
            }
          },
          "legalForms": {
            "title": "Legal forms",
            "type": "array",
            "description": "Empty = all. Derived from the company name.",
            "items": {
              "type": "string",
              "enum": [
                "SL",
                "SLU",
                "SLP",
                "SLL",
                "SLNE",
                "SA",
                "SAU",
                "SAL",
                "COOP",
                "AIE",
                "SC",
                "SICAV",
                "FOREIGN",
                "FOREIGN_BRANCH",
                "OTHER"
              ],
              "enumTitles": [
                "S.L. (limited company)",
                "S.L.U.",
                "S.L.P. (professional)",
                "S.L.L. (labour)",
                "S.L.N.E.",
                "S.A. (public limited company, incl. SAD)",
                "S.A.U.",
                "S.A.L.",
                "Cooperative",
                "A.I.E. (economic interest grouping)",
                "Sociedad civil",
                "SICAV",
                "Foreign company",
                "Branch of a foreign company",
                "Other"
              ]
            }
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Keep acts whose company name or business purpose (objeto social) contains any of these words, accent-insensitive, e.g. solar, software, restaurante, inmobiliaria, transporte. Empty = all.",
            "items": {
              "type": "string"
            }
          },
          "minCapital": {
            "title": "Min share capital (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Optional. Keep acts that state a share capital (constitution capital or resulting capital after a change) of at least this amount."
          },
          "excludeSocietiesCiviles": {
            "title": "Exclude sociedades civiles",
            "type": "boolean",
            "description": "Civil partnerships are usually named after their partners; excluded by default. Sole traders (Empresario Individual) are always excluded.",
            "default": true
          },
          "date": {
            "title": "Publication date (optional)",
            "type": "string",
            "description": "YYYY-MM-DD. The newest BORME on or before this date is read. Default: today (Madrid time), so the latest edition."
          },
          "daysBack": {
            "title": "Publication days",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Number of BORME editions to read, newest first. BORME is published Monday to Friday; one edition has ~2,000-3,000 company acts.",
            "default": 1
          },
          "mode": {
            "title": "Mode",
            "enum": [
              "window",
              "sinceLastRun"
            ],
            "type": "string",
            "description": "sinceLastRun remembers delivered acts (per state key, 60 days) and only returns new ones. Use it for daily schedules with Publication days = 3.",
            "default": "window"
          },
          "stateKey": {
            "title": "State key",
            "type": "string",
            "description": "Separate memory for different sinceLastRun schedules.",
            "default": "default"
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 20000,
            "type": "integer",
            "description": "Cap on delivered acts (also caps your spend).",
            "default": 30
          },
          "concurrency": {
            "title": "Concurrency",
            "minimum": 1,
            "maximum": 3,
            "type": "integer",
            "description": "Province pages fetched in parallel (polite to boe.es).",
            "default": 2
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}