borsch.ai REST API
Integrate UK business intelligence into your applications. Search companies, retrieve risk scores, access signals, and query the entity graph programmatically.
The borsch.ai API provides RESTful access to UK company data, risk scores, signals, and graph analytics. All responses are JSON. Authentication is via Bearer token (JWT) or API key.
Base URL: https://borsch.ai/api/v1
Authentication
All API requests require authentication. Include your token in the Authorization header.
Authorization: Bearer YOUR_API_KEY in every request. Generate API keys from your Account Settings.curl -H "Authorization: Bearer YOUR_API_KEY" \ https://borsch.ai/api/v1/search/structured?query=Tesco
import requests
headers = {"Authorization": "Bearer YOUR_API_KEY"}
resp = requests.get(
"https://borsch.ai/api/v1/search/structured",
params={"query": "Tesco"},
headers=headers,
)
companies = resp.json()const resp = await fetch(
"https://borsch.ai/api/v1/search/structured?query=Tesco",
{ headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
const companies = await resp.json();Search
Search UK companies by name, number, SIC code, location, or semantic similarity.
| Method | Endpoint | Description |
|---|---|---|
| GET | /search/structured | Structured company search with filters (name, SIC, status, region) |
| GET | /search/semantic | Semantic vector search — find companies by what they do |
| GET | /search/suggest | Auto-complete suggestions for company names |
| GET | /search/by-location | Geographic search by coordinates and radius |
Company
Retrieve detailed company information including officers, PSC, filings, and enriched data.
| Method | Endpoint | Description |
|---|---|---|
| GET | /search/company/{number} | Full company profile with officers and enriched data |
| GET | /search/company/{number}/similar | Find similar companies using vector similarity |
Signals
Access 50M+ signals from 53 government data sources for any UK company.
| Method | Endpoint | Description |
|---|---|---|
| GET | /signals/companies/{number}/signals | All signals for a company (paginated) |
| GET | /signals/companies/{number}/risk-score | Weighted risk score v1 (0-100) |
| GET | /signals/summary | Global signal statistics |
| GET | /signals/sources | List all data sources with counts |
Risk Score v2
Multi-dimensional risk assessment across 5 dimensions and 28 sub-scores.
| Method | Endpoint | Description |
|---|---|---|
| GET | /risk/companies/{number}/score | Full multi-dimensional risk assessment |
| GET | /risk/companies/{number}/score/dimension/{key} | Deep dive into a single risk dimension |
Graph
Query the Neo4j knowledge graph with 56.7M nodes and 80M+ relationships.
| Method | Endpoint | Description |
|---|---|---|
| GET | /graph/company/{number}/signals | Individual signals from Neo4j graph |
| GET | /graph/company/{number}/risk-analysis | Cross-source risk breakdown |
| GET | /graph/company/{number}/entity-network | Shared entities (LightRAG) |
| GET | /graph/company/{number}/profile | Full due diligence profile |
| GET | /graph/risk-clusters | Multi-source risk early warning clusters |
| GET | /graph/analytics/summary | Graph statistics (cached 15min) |
Rate Limits
API rate limits depend on your subscription plan.
Ready to integrate?
Get your API key and start building with UK business intelligence data in minutes.