Sub-20ms UK Companies House API: Address Sanitization, KYB & Balance Sheet Extraction
Описание и применение
API обеспечивает быстрый (<20 мс) доступ к данным Companies House, нормализует адреса, добавляет GPS‑координаты, классифицирует директоров и извлекает балансовые данные из PDF.
Задача
Companies House data often suffers from rate‑limit dropouts, all‑caps addresses, missing GPS coordinates, dropped leading zeroes on Scottish company numbers, and balance sheet PDFs that are hard to query or render.
Результат
The API delivers clean, enriched data and fast PDF access, eliminating common Companies House data issues and enabling real‑time lookups in under 20 ms.
Рабочий процесс
- Send a request to the sub‑20ms API endpoint with a Companies House company number or filing ID.
- The API normalizes the address string to title case and attaches GPS coordinates.
- It categorizes directors as active or resigned.
- It scans the filing PDF, extracts balance sheet metrics, and returns them as JSON.
- If a PDF is requested, the API streams it via CORS‑enabled proxy for direct embedding.
- The response is delivered in under 20 ms.
- Use the live sandbox at https://uk-business-sanitizer-demo.jamesforsyth1829.workers.dev for testing. For Laravel, install the open‑source wrapper jamesforsyth/laravel-uk-kyb-edge from Packagist.
Доказательства
Rate‑limit dropouts (HTTP 429 Too Many Requests)
ALL‑CAPS addresses and missing GPS coordinates
Balance sheet PDFs you can't easily query or render in browser apps
The sub‑20ms API and web demo are live in production today!
Address Normalization: Cleans raw strings into Title Case and attaches verified WGS‑84 GPS coordinates.
Directors KYB: Categorizes active vs. resigned board officers instantly.
Automated Vision Extraction: Scans filing PDFs and parses balance sheet metrics into clean JSON.
CORS PDF Streaming: Proxies official filing PDFs directly into web portals and iFrames.
- Дата записи: 2026-10-16T20:56:00.050Z