DEV Community

James
James

Posted on Edited on

Building a Sub-20ms UK Companies House & Financial Vision API

Connecting to government registries often comes with common pain points: rate-limit cascades (HTTP 429 errors), messy non-standardized address strings, missing GPS coordinates, and unstructured balance sheet PDFs.

To solve this, I built the UK Business Data, Address Sanitizer & Financial Intelligence API—a high-speed, enterprise-grade global proxy that standardizes company records, retrieves live board officers, and extracts financial metrics from filing PDFs into clean JSON.


What The API Solves

  1. Smart Address Normalization & Geocoding
    Messy registered office addresses are automatically reformatted into Title Case and enriched with verified WGS-84 GPS coordinates (latitude, longitude, and administrative district).

  2. Automated Balance Sheet Extraction
    Instead of forcing analysts to manually read filing PDFs, the /financials endpoint passes document streams to custom Vision Models to parse unstructured balance sheets into strictly-typed JSON schemas.

  3. High-Speed Document Proxy Streaming
    The /document endpoint proxies Companies House S3 buckets with CORS headers injected, enabling direct PDF rendering inside web portals and iFrames.

  4. Zero Rate-Limit Dropouts
    An intelligent, distributed 24-hour caching layer absorbs upstream rate surges to eliminate 429 dropouts and deliver sub-20ms response times.


Native Laravel Package

If you're building in PHP/Laravel, you can install the official open-source package directly:

composer require jamesforsyth/laravel-uk-kyb-edge

GitHub: James-2050/laravel-uk-kyb-edge

Packagist: jamesforsyth/laravel-uk-kyb-edge

Try the Live Sandbox

You can test the endpoints live directly in your browser without needing an API key:

👉 Live Sandbox & Demo: uk-business-sanitizer-demo.jamesforsyth1829.workers.dev

👉 RapidAPI Hub: UK Business Data & Address Sanitizer on RapidAPI

Top comments (0)