🏢 UK Companies House Enrichment & B2B Intel API

Exposes an enterprise-grade, two-tiered business intelligence query interface for UK Companies House records under the Pay-Per-Event (PPE) pricing model. Ideal for sales intelligence, automated lead enrichment, cold outreach compliance auditing, cybersecurity risk assessment, and HR tech integrations.

---

⚡ What This Actor Does

This actor bypasses basic registry lookups by returning a fully enriched, commercial-ready profile of active, medium-to-large UK corporate entities. It integrates multi-source intelligence—combining official government registry details, corporate financial statements, email/DNS security auditing, active web technographics, and live applicant tracking systems (ATS) hiring data.

[!IMPORTANT] Enrichment Scope Constraint Comprehensive enrichment profiles (Tier 2) are strictly generated and stored only for active, medium-to-large corporate targets (e.g., companies that file detailed financial statements, have active digital footprints, or run active recruitment).

Queries for micro-entities, small businesses, sole traders, or dormant/inactive entities will return a 404-style error payload (and will NOT charge you the premium Tier 2 billing event rate).

The actor operates in two cost-optimized tiers:

🔍 Tier 1: Fuzzy Name Search (company-search)

• Purpose: Resolve partial or fuzzy company names to absolute identifiers.
• Performance: Sub-100ms response times powered by a pre-indexed Key-Value store (with native Google BigQuery fallback).
• Data Returned: Company name, registration number, registration status, and postcode.

💎 Tier 2: Detailed Enrichment (company-detail)

• Purpose: Retrieve the full B2B intelligence profile using an 8-digit company number.

• Target Scope: Limited to active, medium-to-large corporate targets. Queries for companies outside this scope return a 404-style error message to avoid charging premium billing events.

• Data Returned: Comprehensive corporate profiling containing:

  • Registry & Financials: Net assets, annual turnover, employee counts, and balance sheet dates.
  • Web Technographics: Instantly detects active frameworks and trackers on their domain (WordPress, Shopify, Next.js, Webflow, Google Tag Manager, GA4, HubSpot, Hotjar, Meta Pixel, Intercom, Zendesk).
  • Email & DNS Audit: Identifies active ESP providers (Google Workspace, Office 365, etc.) and performs a real-time SPF, DMARC, and DKIM selector safety audit to generate an aggregate Cyber Hygiene Score (0-100) and risk tier.
  • ATS & Recruiting Scans: Queries live recruitment endpoints (Greenhouse, Workday, Lever, Workable, etc.) to fetch the exact count of active job listings and details of open roles.
  • PECR Cold Email Compliance: Calculates corporate eligibility and provides legal justification for cold B2B outreach under UK PECR laws.
  • ICO Triangulation: Verifies registration status on the official UK Information Commissioner's Office data protection register.

---

⚙️ Input Schema

The actor accepts the following parameters. You must supply either companyName (for Tier 1 Search) or companyNumber (for Tier 2 Detail lookup).

Field	Type	Title	Description
companyName	string	Company Name (Fuzzy Search)	Fuzzy or partial company name (e.g., "Tesco"). Activates Tier 1 Search Mode.
companyNumber	string	Company Number (Premium Lookup)	Exact 8-digit UK company number (e.g., "01234567"). Activates Tier 2 Detail Mode. Note: Enriched profiles only exist for active, larger corporate targets (medium/large enterprises).
maxSearchResults	integer	Max Search Results	Maximum results to return in Tier 1 Search (Default: 10, Max: 100).

Input JSON Examples

1. Fuzzy Name Search (Tier 1)

{
  "companyName": "Tesco",
  "maxSearchResults": 5
}

2. Detailed B2B Profile Lookup (Tier 2)

{
  "companyNumber": "00471817"
}

---

📊 Output Schema (Tier 2 Example)

When querying via companyNumber in Tier 2, the actor yields a rich, structured intelligence profile formatted as a JSON object:

{
  "company_number": "00471817",
  "company_name": "TESCO PLC",
  "last_enriched_at": "2026-07-05T12:30:45Z",
  "enrichment_status": "completed",
  "resolved_domain": "tescoplc.com",
  "email_provider": "Microsoft Office 365",
  "dns_security": {
    "cyber_hygiene_score": 85,
    "cyber_security_risk_tier": "Low Risk",
    "spf": {
      "valid": true,
      "record": "v=spf1 include:spf.protection.outlook.com -all",
      "warnings": []
    },
    "dmarc": {
      "valid": true,
      "record": "v=DMARC1; p=reject; pct=100; rua=mailto:dmarc-rua@tescoplc.com",
      "warnings": []
    },
    "dkim": {
      "has_active_selector": true,
      "selectors_checked": {
        "selector1": "active"
      }
    },
    "mx_hosts": [
      "tescoplc-com.mail.protection.outlook.com"
    ],
    "issues": []
  },
  "compliance": {
    "is_corporate_subscriber": true,
    "legal_entity_type": "plc"
  },
  "technographics": {
    "wordpress": false,
    "shopify": false,
    "gtm": true,
    "hubspot": false,
    "ga4": true,
    "meta_pixel": true,
    "hotjar": false,
    "intercom": false,
    "zendesk": false,
    "nextjs": true,
    "webflow": false
  },
  "recruiting": {
    "is_hiring": true,
    "ats_source": "Workday",
    "roles_count": 18,
    "roles_extracted": [
      {
        "title": "Lead Software Engineer - Python",
        "location": "Welwyn Garden City",
        "url": "https://tesco.wd3.myworkdayjobs.com/Careers/job/Lead-Software-Engineer"
      }
    ]
  },
  "ico_triangulation": {
    "registered": true,
    "registration_number": "Z6294371",
    "tier": "Tier 3",
    "expiry_date": "2027-01-20"
  },
  "financial_metrics": {
    "net_assets": 11842000000.0,
    "turnover": 68193000000.0,
    "employee_count": 330000,
    "balance_sheet_date": "2026-02-28"
  },
  "commercial_insights": {
    "company_size_segment": "Enterprise",
    "outreach_eligibility": {
      "can_cold_email": true,
      "compliance_reason": "Legitimate interest allowed for UK corporate entities (LTD, PLC, LLP) under PECR rules"
    },
    "cyber_security_risk_tier": "Low Risk",
    "growth_hiring_indicator": "High Growth"
  }
}

---

💡 Key Use Cases

1. Lead Enrichment & Scoring: Automatically feed Companies House numbers from forms into the actor to instantly qualify prospects by employee size, technology stack, and hiring status.
2. Cold Outreach Compliance Filters: Filter out sole traders and partnerships automatically to ensure your email campaigns strictly adhere to UK PECR regulations.
3. Cyber Hygiene Analysis: Audit the DNS records (SPF, DMARC, DKIM) of target lists to score domain safety and identify prospects in need of cybersecurity solutions.
4. Technographic Profiling: Target companies using specific technologies (e.g., Next.js, HubSpot, Shopify) for hyper-targeted product positioning.
5. Recruiting & Growth Signals: Track active roles on target company boards to identify hiring expansion and allocate resources or outreach efforts effectively.