United Kingdom · solution reference

UK Company Check

RunOnProof answers this one bounded UK business question and returns the evidence, limits and next machine action with the answer. A successful HTTP response is not automatically permission to proceed.

SOLUTION

Canonical ID

gb.solution.company_check.v1 · POST /v1/gb/solutions/company-check · 0.04 USDC per settled delivery

Problem it solves

Check a UK company by resolving its Companies House identity and verifying current legal-status and insolvency observations in one paid call. Use before onboarding or contracting. It reports filing limits and does not promise universal good standing.

When to use

check a UK company
verify a British company

When not to use

credit scoring
universal good-standing opinions

Coverage and limitations

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

Check a UK company by resolving its Companies House identity and verifying current legal-status and insolvency observations in one paid call. Use before onboarding or contracting. It reports filing limits and does not promise universal good standing.
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.04 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 company_name postal_code idempotency_key

Complete request example

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

Complete response example

Illustrative contract shape.

Live evidence, health, coverage, decision, reason codes, validity and payment state prevail.

{
  "schema_version": "1.0.0",
  "product_or_solution": "gb.solution.company_check.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_CHECK_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 scoring.",
    "Does not provide universal good-standing opinions."
  ],
  "economic_activity": {
    "charged": true,
    "quote_created": true,
    "settlement_created": true
  },
  "payment": {
    "protocol": "x402",
    "payment_status": "SETTLED",
    "charged_price_usd": 0.04,
    "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",
    "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

Composes gb.legal_entity.resolve.v1, gb.company.legal_status.verify.v1.
A committed result may contribute scoped claims to company.capability.passport.v1.

Copyable quickstart

curl -i -sS -X POST https://api.runonproof.com/v1/gb/solutions/company-check \
+  -H 'Content-Type: application/json' \
+  -H 'Idempotency-Key: bazaar_gb_solution_company_check_v1' \
+  -H 'X-CDO-Request-Body-Digest: sha256:9167da4d155fe4be5df76cdec4a77a3f059950cfcf3a8b8e4889ccc97005e146' \
+  --data '{"company_number":"00006400","idempotency_key":"bazaar_gb_solution_company_check_v1"}'

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