API Reference
Integrate UK business intelligence into your applications. Search companies, retrieve risk scores, access signals, and query the entity graph programmatically.
The uvagatron.com 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.
https://uvagatron.com/api/v1Authentication
All API requests require authentication. Include your token in the Authorization header. Generate API keys from your Account Settings.
curl -H "Authorization: Bearer YOUR_API_KEY" \ https://uvagatron.com/api/v1/search/structured?query=Tesco
import requests
headers = {"Authorization": "Bearer YOUR_API_KEY"}
resp = requests.get(
"https://uvagatron.com/api/v1/search/structured",
params={"query": "Tesco"},
headers=headers,
)
companies = resp.json()const resp = await fetch(
"https://uvagatron.com/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 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 millions of signals from 48+ government data sources.
| 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
Multi-dimensional risk assessment. See Risk Score guide for methodology.
| 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 knowledge graph for entity networks and risk analysis.
| Method | Endpoint | Description |
|---|---|---|
| GET | /graph/company/{number}/signals | Individual signals from knowledge graph |
| GET | /graph/company/{number}/risk-analysis | Cross-source risk breakdown |
| GET | /graph/company/{number}/entity-network | Shared entities and connections |
| GET | /graph/company/{number}/profile | Full due diligence profile |
| GET | /graph/risk-clusters | Risk early warning clusters |
| GET | /graph/analytics/summary | Graph statistics |
Rate Limits
API rate limits depend on your subscription plan. See Tokens & Limits for full details.