Developer API
A REST API to the same Companies House data, parsing pipeline, financial calculations, and source metadata that powers every filing brief — use it for filing research, CRM enrichment, or filing-change workflows. Built for production use, billed by call, no monthly seat fees.
Sample request
# Company profile + officers + PSCs for BrewDog PLC curl -H "X-API-Key: vai_..." \ "https://www.verif-ai.co.uk/api/v1/companies/SC311560" # Response (truncated) { "company_number": "SC311560", "company": { "company_name": "BREWDOG PLC", "company_status": "Active" }, "officers": [ ... ], "pscs": [ ... ], "counts": { "officers": 8, "pscs": 1 } }
Built for
Verif-AI's API is for production workflows that need a structured, source-linked view of a UK company's public record — without a human reading every PDF manually.
Pull cash, debt, audit opinion, filing dates, and source metadata for every UK company. Keep the filing evidence alongside your own workflow and refresh it when a new filing arrives.
Endpoints: /api/company/<n>/financials
Pull the Companies House identity, officers, PSCs, ownership context, and named source metadata in one structured response. Keep the underlying record with your own review workflow.
Endpoints: /api/v1/companies/<n>, /api/company/<n>/people (GDPR-tiered)
Hydrate every UK company record in Salesforce / HubSpot / your CRM with company status, registered office, sector (SIC), latest revenue, and director list. One call per record; cache for the period you care about.
Endpoints: /companies/<n>
Monitor a portfolio for new accounts, director moves, charges, status changes, and named source-list updates. Use the API with your own alerting, or use our hosted watchlist.
Endpoints: /api/v1/companies/<n>, /api/v1/companies/<n>/director-intelligence
What you get
Company identity, status, registered office, current officers and persons with significant control, returned in a single structured response.
Up to 7 years of structured financials extracted from iXBRL and PDF filings. Turnover, profit, cash, assets, liabilities — all in GBP, unrounded, with null for any missing field.
Active and historical directors, PSCs with control descriptions, and board-level appointment context. GDPR-tiered address access is permission-gated.
Endpoints
All requests are authenticated with a single X-API-Key header. Missing fields return null — never guessed or fabricated.
Unified company profile with status, registered office, current officers and persons with significant control. This is the v1 profile resource; use the resource endpoints below for financials and historic officer detail.
Career-long director profile from the local Companies House appointment dataset.
Board-level appointment and company context for a company, with optional historic appointments.
Up to 7 years of structured financials from iXBRL filings. Add ?extract_pdf=1 only when your key has PDF extraction permission; that mode can incur extraction cost and additional latency.
Active and historical officers, PSCs and registered-office context. Director residential addresses are permission-gated.
Example
Five years of structured financials for BrewDog PLC, with PDF extraction enabled for their large PDF filings.
# 5 years — PDF extraction on curl -H "X-API-Key: vai_..." \ "https://www.verif-ai.co.uk/api/company/SC311560/financials?years=5&extract_pdf=1"
{
"company_number": "SC311560",
"company_name": "BREWDOG PLC",
"extract_pdf_used": true,
"financials": [
{
"year": "FY2024",
"cash_at_bank": 31117000,
"total_assets": 440930000,
"current_liabilities": 156279000,
"annual_turnover": 357037000,
"net_profit": -34557000,
"profit_margin": -9.68
}
// ... FY2023, FY2022, FY2021 ...
]
}
All amounts in GBP, unrounded. Missing fields return null. Full field schema provided with your API key.
Pricing
API access is metered per call. No minimum commitment to start; volume discounts apply automatically as you scale. Public-record endpoints (profile, officers, status) cost less than filing-brief endpoints (with financial extraction, source metadata, and AI synthesis).
Company profile, status, officers, PSCs, basic financials. Returns null on missing fields — never guesses.
Full filing brief: source-linked plain-English summaries, 7-year financials, named source checks, and director cross-checks.
Volume discount, dedicated rate-limit headroom, signed SLA, residential-address access, optional dedicated extraction priority. Contact us.
Volume discounts kick in automatically. Pricing transparent on every invoice. Talk to us if you're forecasting 10,000+ calls/month — that conversation is short and we can usually quote in 24 hours.
Reliability
Companies House dependency disclosed; we serve cached responses on upstream outages where applicable.
Public-record endpoints are served from our 5 million+ company cache. Filing-brief calls take longer (2-5 min) since they re-parse the latest filing.
Higher quotas on request. Standard X-RateLimit-Remaining + Retry-After headers on every response.
Data hosted in London (Neon eu-west-2). Director residential addresses are gated; granted only on documented legitimate interest.
Get started
Send us the four details below — we'll have your API key, starter quota, and full endpoint reference back within one working day. No procurement portal, no sales call.
Request API access →