Verify UK Company Legal Status

Problem it solves

Verify the current Companies House legal status, overdue filing indicators and recorded insolvency observations for a UK company. Use before onboarding or a material decision; the result is source-scoped, not a universal good-standing certificate.

Coverage and limitations

AVAILABLE. UK_COMPANIES_HOUSE within Companies House registered UK entities and the exact declared caller-evidence boundary.

• Verify the current Companies House legal status, overdue filing indicators and recorded insolvency observations for a UK company. Use before onboarding or a material decision; the result is source-scoped, not a universal good-standing certificate.
• No omitted source, field or population may be inferred.
• An HTTP 200 response may still require review, retry or stop.

Freshness. Read valid_as_of, valid_until, each evidence timestamp and source_health on every response. Expired or stale mandatory evidence cannot support continuation.

Source provenance

Sources: UK_COMPANIES_HOUSE

Every source observation carries its source ID and URL, source version/timestamp, retrieval time, parser version, raw SHA-256 digest, freshness and scoped claims. Caller/provider evidence remains labelled as an attestation.

Failure and attention states

A required source that is unavailable, stale, disabled or schema-broken produces RETRY or NO_DECISION with HOLD and no settled delivery. Partial or ambiguous evidence produces REVIEW/HOLD. It never becomes a clean finding.

Decisions or lifecycle states: APPROVE CONDITIONAL REVIEW BLOCK RETRY NO_DECISION

Representative reason codes: CURRENT_EVIDENCE_WITHIN_DECLARED_COVERAGE LIMITED_COVERAGE SOURCE_UNAVAILABLE SOURCE_STALE SOURCE_SCHEMA_BREAK EVIDENCE_INSUFFICIENT

A person must review REVIEW, HOLD, RETRY, NO_DECISION, LIMITED/conditional results, every HTTP 402 quote before payment, and any consequential action required by the caller's policy. BLOCK/DENY means stop.

x402 and price

The live economic path is allowlisted at 0.03 USDC on Base. A request without Payment-Signature receives HTTP 402 with a body-bound quote. Do not sign or retry automatically; invalid input, source failure and undelivered decisions are not charged.

Input fields

company_number idempotency_key

Complete request example

{
  "company_number": "00006400",
  "idempotency_key": "bazaar_gb_company_legal_status_verify_v1"
}

Complete response example

{
  "schema_version": "1.0.0",
  "product_or_solution": "gb.company.legal_status.verify.v1",
  "request_id": "gbreq_documentation_example",
  "execution_id": "gbexec_documentationexample",
  "delivery_id": "gbdel_documentationexample",
  "replayed": false,
  "decision": "APPROVE",
  "authorization": "ALLOW",
  "machine_action": "CONTINUE_WITHIN_DECLARED_COVERAGE",
  "policy": {
    "id": "GB_COMPANY_STATUS_V1",
    "version": "1.0.0",
    "checksum": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  },
  "reason_codes": [
    "CURRENT_EVIDENCE_WITHIN_DECLARED_COVERAGE"
  ],
  "conditions": [],
  "required_information": [],
  "coverage": {
    "country": "GB",
    "jurisdiction": "UNITED_KINGDOM",
    "population": "COMPANIES_HOUSE_REGISTERED_ENTITIES",
    "supported": true,
    "limitations": [
      "Source-scoped UK evidence only"
    ]
  },
  "source_health": {
    "UK_COMPANIES_HOUSE": "HEALTHY"
  },
  "evidence": [
    {
      "evidence_id": "ev_docs_1",
      "source_id": "UK_COMPANIES_HOUSE",
      "source_url": "https://find-and-update.company-information.service.gov.uk/",
      "source_version": "documentation-example-1.0.0",
      "source_timestamp": "2030-01-02T11:55:00.000Z",
      "retrieved_at": "2030-01-02T12:00:00.000Z",
      "parser_version": "documented-contract-1.0.0",
      "raw_sha256": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
      "freshness": "FRESH",
      "claims": [
        "Illustrative source-scoped claim; inspect the live response"
      ]
    }
  ],
  "valid_as_of": "2030-01-02T12:00:00.000Z",
  "valid_until": "2030-01-02T13:00:00.000Z",
  "limitations": [
    "This example is illustrative; live evidence, coverage, health and reason codes prevail.",
    "Does not provide credit ratings.",
    "Does not provide legal advice."
  ],
  "economic_activity": {
    "charged": true,
    "quote_created": true,
    "settlement_created": true
  },
  "payment": {
    "protocol": "x402",
    "payment_status": "SETTLED",
    "charged_price_usd": 0.03,
    "network": "eip155:8453",
    "asset": "USDC",
    "persistence_status": "PERSISTED"
  },
  "result": {
    "company_number": "00006400",
    "company_name": "THE GIRLS' DAY SCHOOL TRUST",
    "uk_legal_status": "ACTIVE_AS_REGISTERED",
    "companies_house_status": "active",
    "filing_state": {
      "accounts_overdue": false,
      "confirmation_statement_overdue": false
    },
    "insolvency_cases": 0
  }
}

Idempotency, replay and security

Idempotency. Use one stable body idempotency_key and the identical Idempotency-Key header. Reusing the key with a different payload or digest returns 409 and never creates a second charge.

Replay. GET /v1/gb/executions/{executionId} returns the persisted semantic delivery with zero live source calls, signing, settlement or additional charge.

Security and privacy. Send opaque payee fingerprints and non-secret evidence references only. Never send raw bank details, wallet keys, payment secrets or credentials. Evidence and responses retain only the minimum source-scoped material required for audit.

Relationship to the UK V1 core

• May be used by one or more UK V1 composed solutions.
• A committed result may contribute only its evidence-bound claim to company.capability.passport.v1.

Copyable quickstart

curl -i -sS -X POST https://api.runonproof.com/v1/gb/companies/legal-status \
+  -H 'Content-Type: application/json' \
+  -H 'Idempotency-Key: bazaar_gb_company_legal_status_verify_v1' \
+  -H 'X-CDO-Request-Body-Digest: sha256:dd9a8cc0b759a227b3b0e357e240e9ca9d1d11a0ed316ede276f1ce68c2017ab' \
+  --data '{"company_number":"00006400","idempotency_key":"bazaar_gb_company_legal_status_verify_v1"}'

OpenAPI reference → · UK country pack → · UK manifest → · Company Capability Passport →