Zum Inhalt
HALOWERK

Finanzwerk

entity monitor

In search mode, finds UK companies by name. In monitor mode, fetches the current company profile and filing history and compares it with the transaction id or filing date supplied by the caller. The response states whether the baseline was found and lists filings newer than that baseline. This is a pull comparison, not a subscription or push alert. Requests are rate-limited in code below the Companies House ceiling of 600 requests per five minutes.

POST https://finanz.halowerk.com/v1/entity-monitor

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
actionstringJa
querystringNeinCompany name for action=search.
company_numberstringNeinCompanies House number for action=monitor.
known_latest_transaction_idstringNeinLast transaction id seen by the caller.
known_filing_datestringNeinFallback baseline date, YYYY-MM-DD.
limitintegerNein
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "action"
  ],
  "additionalProperties": false,
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "search",
        "monitor"
      ]
    },
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "Company name for action=search."
    },
    "company_number": {
      "type": "string",
      "minLength": 6,
      "maxLength": 10,
      "description": "Companies House number for action=monitor."
    },
    "known_latest_transaction_id": {
      "type": "string",
      "minLength": 2,
      "maxLength": 100,
      "description": "Last transaction id seen by the caller."
    },
    "known_filing_date": {
      "type": "string",
      "format": "date",
      "description": "Fallback baseline date, YYYY-MM-DD."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "action": "monitor",
  "company_number": "00000006",
  "known_filing_date": "2025-01-01",
  "limit": 20
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →