COMPLIANCE & RISK

Live UK Company Profile & Filing Status

Fetch current public-register facts for one UK company by exact company number from the official Companies House Public Data API. Returns company status and type, incorporation date, SIC codes, registered-office locality and postcode, and accounts and confirmation-statement due or overdue facts.

post/execute/companies-house-live-profile-v1

Request

  • Base URL: https://api.macaroonnetwork.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.macaroonnetwork.com/execute/companies-house-live-profile-v1
  • Auth: none declared

Request body

predicateobject required

Acceptance predicate evaluated before settlement.

Example request

{
  "predicate": {
    "type": "all",
    "conditions": [
      {
        "type": "field_changed",
        "field": "$.record.source",
        "value": "Companies House Public Data API",
        "operator": "eq"
      },
      {
        "type": "field_changed",
        "field": "$.provenance.metadata_only",
        "value": true,
        "operator": "eq"
      },
      {
        "type": "field_changed",
        "field": "$.provenance.live_data",
        "value": true,
        "operator": "eq"
      },
      {
        "type": "field_changed",
        "field": "$.provenance.outbound_network_used",
        "value": true,
        "operator": "eq"
      }
    ]
  }
}

Response

Predicate-gated result and commercial receipt.

predicate_passedboolean required
receiptobject required

Changes

No recorded changes to this operation across all 1 revision of this API.