{"openapi":"3.0.3","info":{"title":"UK Company Data API","version":"0.2.0","description":"Structured financial data from UK Companies House filings (AI-extracted PDF accounts + iXBRL). Companies House data used under the Open Government Licence v3.0. Not a credit rating."},"servers":[{"url":"https://data.globalmindsetmarketing.co.uk"}],"paths":{"/v1/company":{"get":{"summary":"Look up a UK company by company number. Returns register details, latest financials (iXBRL figures as filed at Companies House and/or AI-extracted estimates from PDF accounts), risk signals and trajectory. Note: 'Total assets less current liabilities' and 'Creditors' are reported as filed; dates are balance sheet dates.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing/invalid API key"},"429":{"description":"Quota exceeded"}}}},"/v1/search":{"get":{"summary":"Search UK companies by financial criteria. Returns up to 50 matches.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing/invalid API key"},"429":{"description":"Quota exceeded"}}}},"/v1/compare":{"get":{"summary":"Compare two UK companies side by side.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing/invalid API key"},"429":{"description":"Quota exceeded"}}}},"/v1/stats":{"get":{"summary":"Get aggregate market statistics across all companies in the database.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing/invalid API key"},"429":{"description":"Quota exceeded"}}}},"/v1/triggers":{"get":{"summary":"Find companies matching specific financial triggers useful for B2B lead generation.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing/invalid API key"},"429":{"description":"Quota exceeded"}}}},"/v1/search-by-name":{"get":{"summary":"Search all UK companies (Companies House register, ~5.6M) by name. Ranking: exact name match (ignoring LTD/LIMITED/PLC etc.) first, then active companies, then names starting with or containing the phrase, then other matches (words match as prefixes). Returns company numbers for lookup_company.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing/invalid API key"},"429":{"description":"Quota exceeded"}}}},"/v1/watchlist":{"get":{"summary":"Show your monitoring watchlist with each company's current status, accounts due date and latest balance sheet date.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing/invalid API key"},"429":{"description":"Quota exceeded"}}}},"/v1/watchlist/add":{"post":{"summary":"Add UK companies (by company number) to your monitoring watchlist. The current Companies House state is snapshotted; get_alerts then reports status changes, overdue accounts, new accounts, new charges and financial deterioration. Watchlist size: 5 companies on Free, 50 on Pro.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing/invalid API key"},"429":{"description":"Quota exceeded"}}}},"/v1/watchlist/remove":{"post":{"summary":"Remove companies from your monitoring watchlist.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing/invalid API key"},"429":{"description":"Quota exceeded"}}}},"/v1/alerts":{"get":{"summary":"Monitoring alerts for your watchlist: status changes (liquidation, administration, strike-off), overdue accounts, newly registered or published accounts, new charges, negative net assets, and drops of 30%+ in net assets or cash between the last two iXBRL accounts. Sorted by severity.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing/invalid API key"},"429":{"description":"Quota exceeded"}}}},"/v1/recent-changes":{"get":{"summary":"List companies whose iXBRL accounts were published at Companies House in the last N days (by publication date; each row also shows the balance sheet date). Useful for monitoring a watchlist or finding fresh signal.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing/invalid API key"},"429":{"description":"Quota exceeded"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}