XBRL financial extraction, PSC ownership chains, group structure traversal, and filing provenance for 2.7M+ UK company records. One API call.
11 company endpoints plus 8 lender intelligence endpoints, stats, health, and MCP tooling
/v1/companies/search/Filter by SIC code, revenue range, employee count, location, data quality tier, and more.
/v1/companies/compareSide-by-side comparison of up to 10 companies across enrichment dimensions.
/v1/companies/{number}Full company profile with financials, ownership, constraints, and quality signals.
/v1/companies/{number}/financialsMulti-year XBRL financial history. Balance-sheet fields are broadest; revenue, profit, cash-flow, and liquidity metrics depend on filing type.
/v1/companies/{number}/time-seriesTrend summaries and arrays for reported metrics across filing years. Coverage is materially deeper on full accounts than abridged filings.
/v1/companies/{number}/ownershipPSC beneficial owners, age estimation, and corporate ownership structure.
/v1/companies/{number}/ownership-graphPSC-to-management graph for group structure traversal.
/v1/companies/{number}/constraintsFlags secured lending constraints such as floating/fixed charges and unsatisfied encumbrances.
/v1/companies/{number}/explainReturns filing URL, chosen XBRL tags, and extraction confidence for key metrics.
/v1/companies/{number}/deal-snapshotSingle-call buyability summary combining owner, financial, and constraint signals.
/v1/companies/{number}/share-eventsSH01/SH03/SH06 capital filing timeline — allotments, buybacks, and cancellations with share class, quantity, consideration, and post-event capital snapshots.
/v1/lendersPaginated list of canonical UK lenders ranked by charge activity. Filter by classification (bank, challenger_bank, building_society, specialist_mortgage, private_credit, asset_finance, invoice_finance, …), activity window, minimum charge count, or free-text name match. Pass ?include=series for 24-month sparkline data.
/v1/lenders/{id}Canonical lender with parent/subsidiary structure, raw alias list, and aggregate charge stats (totals + recent activity).
/v1/lenders/{id}/portfolioPaginated companies with charges from this lender, with per-company aggregated counts. Filter by charge status (outstanding | satisfied | all).
/v1/lenders/{id}/activityMonthly new + satisfied charge counts, oldest first. ?months=1..60 controls the trailing window (default 24). Months with no activity are omitted.
/v1/lenders/{id}/sectorsTop-15 SIC-section breakdown of companies this lender has charges against, ranked by charge count.
/v1/lenders/{id}/regionsUK ITL1 regional breakdown of companies this lender has charges against.
/v1/lenders/{id}/size-breakdownRevenue-band breakdown of companies this lender has charges against, ordered by band threshold. The ``Unknown`` band covers companies without a resolved latest_revenue.
/v1/lenders/{id}/instrumentsTop-5 charge-type instruments this lender uses (fixed charge, debenture, floating charge, mortgage, …), ordered by charge count.
Plus GET /health and GET /v1/stats (unauthenticated)
Authenticate with your API key via the X-API-Key header
curl -H "X-API-Key: pk_live_your_key_here" \
https://api.perpetua.uk/v1/companies/12345678{
"company_number": "12345678",
"name": "ACME ENGINEERING LTD",
"sic_codes": ["28110"],
"incorporation_date": "1998-03-15",
"registered_address": "London, England",
"latest_revenue": 4250000,
"latest_net_profit": 680000,
"latest_total_assets": 3100000,
"current_ratio": 2.1,
"debt_to_equity": 0.35,
"data_quality_tier": "gold",
"ownership_type": "Individual Controlled",
"owner_max_age": 67,
"has_family_director": false,
"has_pe_ownership": false
}Coverage Notes
Example payloads are illustrative. Financial field availability varies materially by filing type.
current_ratio, quick_ratio, and working_capital are effectively full-accounts-only for UK companies because current_liabilities is rarely disclosed in abridged filings.
latest_inventory, latest_operating_cash_flow, latest_capex, latest_free_cash_flow, and most latest_interest_expense data are structural full-accounts-only gaps in UK filings and will often be null.
Open static demo company pages with illustrative payloads and no API key.
Enrichment data — facts, not opinions
20+ financial fields with 100+ tag fallbacks. Balance-sheet coverage is broadest; revenue, profit, cash-flow, and ratio depth increases materially on full accounts.
Beneficial owner resolution with age estimation from Companies House birth month/year. See who really owns the company.
Walk PSC ownership chains to map group structures. Identify corporate PSCs, resolve subsidiaries, and traverse multi-layer ownership graphs.
Coverage-aware financial health flags built from reported balance-sheet and profit fields. Liquidity and cash-flow signals are materially narrower on abridged filings.
Gold / silver / review / toxic classification. Use it to gauge how much reported financial detail is actually present for a company.
Filter by SIC code, revenue range, employee count, region, owner age, data quality, and 20+ more parameters.
Try core endpoints through a safe proxy with demo credentials.
cURL
Auto-updatedcurl -H "X-API-Key: <your_api_key>" \
"${PERPETUA_API_URL:-http://localhost:8000}/v1/companies/00445790"Response JSON
{}Create a free account, generate an API key, and start querying 2.7M+ UK company records in minutes.