# UK Company Enrichment

A UK company name or domain → a verified profile in one call.

Companies House facts, an AI summary of what the business actually does, filing signals and an honest accuracy score — on every result.

Raw registry APIs hand you codes and dates and leave the real question — what does this business actually do? — unanswered. This endpoint answers it: one call takes a company name or a bare domain and returns the registered facts from Companies House, an AI-written summary of what the business does read from its own website, filing signals worth acting on, and an accuracy score that shows exactly how the answer was earned. It's the difference between storing data about a company and actually knowing who you're dealing with — and it's the foundation every other API on this platform is built on.

- Price: 2 credits
- Page: https://meetkatalis.com/apis/company-enrichment
- OpenAPI: https://meetkatalis.com/openapi.yaml

## Endpoints

- `GET /api/v1/enrich?q=greggs` — Verified profile
- `POST /api/v1/batch` — Body: { items: [up to 25 names/domains] } — 2 credits each, one call

## Call it

```bash
curl -H "x-api-key: $KATALIS_API_KEY" \
  "https://meetkatalis.com/api/v1/enrich?q=greggs"
```

```javascript
const res = await fetch("https://meetkatalis.com/api/v1/enrich?q=greggs", {
  headers: { "x-api-key": process.env.KATALIS_API_KEY },
});
if (!res.ok) throw new Error(`Katalis ${res.status}: ${await res.text()}`);
console.log(await res.json());
```

```python
import os, requests

r = requests.get(
    "https://meetkatalis.com/api/v1/enrich?q=greggs",
    headers={"x-api-key": os.environ["KATALIS_API_KEY"]},
    timeout=60,
)
r.raise_for_status()
print(r.json())
```

## Example response (a real reply)

```json
{
  "profile": {
    "name": "GREGGS PLC",
    "found": true,
    "companyNumber": "00502851",
    "status": "active",
    "website": "https://www.greggs.com",
    "sicCodes": ["10710", "47240"],
    "incorporationDate": "1951-12-29",
    "sector": "Food and Beverage",
    "whatTheyDo": "Greggs offers a variety of food and drink options including breakfast items, savouries, sandwiches, sweet treats, and hot food.",
    "services": ["online ordering", "Click + Collect", "delivery services"],
    "socials": ["Facebook", "Instagram", "X", "TikTok"],
    "signals": [
      { "code": "established", "kind": "info", "label": "Established 74+ years." }
    ],
    "accuracy": { "score": 100, "confidence": "high" },
    "sources": ["companies-house", "website", "web-search"],
    "attribution": "Contains public sector information licensed under the Open Government Licence v3.0."
  }
}
```

## What you'd build with it

- **CRM autofill.** A new lead types their email — you show their full company profile before your rep even opens the record. One call on the signup webhook.
- **Onboarding & KYB-lite.** Verify who a business actually is (registered name, status, age, what they do) before you extend credit, access or trust.
- **Directories & marketplaces.** Every listing self-populates with verified facts and an AI summary — no manual data entry, no stale profiles.
- **Sales research at machine speed.** The 20 minutes a rep spends googling a prospect becomes a 2-second call — with a filing-signals section researchers usually miss.
- **Data hygiene.** Nightly re-enrichment keeps company records honest: status changes, new SIC codes and dissolved companies surface themselves.

## Why this one

- **Not just registry data.** Companies House gives you codes and dates. We add an AI summary of what the business actually does — the part raw registry APIs can't.
- **An honest accuracy score.** Every result carries a grounded 0–100 confidence score that shows its work, so you know exactly how much to trust it.
- **Built for the UK.** Native Companies House depth — SIC codes, filing signals, incorporation dates — not a global tool bolted onto the UK.
- **Flat, transparent pricing.** Two credits per call on this endpoint on every plan, free included (only the premium endpoints count double on the free tier). No notice periods. Cancel anytime.

## Conventions

- Auth: `x-api-key: kat_live_…` on every request (free key at https://meetkatalis.com/developers: a verified email and mobile, 100 credits a month, no card).
- One credit balance across every API; each endpoint's price is on its page and in `x-credits` in https://meetkatalis.com/openapi.yaml.
- Keys are camelCase everywhere. A registered company is `company: { name, number, status, statusDetail?, filingsOverdue? }` on the register endpoints; the enrichment family (enrich, score, assess, brand-kit, ai-visibility, tender-match) keeps `business` / `profile` with `companyNumber`.
- Every error has `code` and `requestId`; every reply an `x-request-id` header; a charged reply `x-credits-remaining`; a reply that gave credits back `x-credits-refunded`. Missing = 404 with `query`.
- Burst ceiling 60 requests a minute per key (429, `Retry-After`, no credits used). A failure on our side (5xx) gives the call's credits back.
- Company data contains public sector information licensed under the Open Government Licence v3.0.

Provided "as is"; results come from public sources and, in places, AI, and may be inaccurate or out of date; not legal, professional or credit advice. Terms: https://meetkatalis.com/apis/terms