UK Director API — Network Risk Intelligence
The Entity endpoint asks 'is this company healthy?' The Director endpoint asks a different question: 'is this person trustworthy?' Given a director name or Companies House officer ID, it maps their entire company network — every current and past directorship, the status of each company, disqualification checks, and Gazette notices — then distils it into a proprietary Director Risk Score. This is a graph operation, not a simple lookup. It traverses person → companies → company status → red flags across the network. For credit teams, angel investors, franchise operators, and investigative journalists, it replaces hours of manual Companies House research with a single API call.
What You Get
- •Director profile: name, officer ID, date of birth, total appointment count
- •Director Risk Score (0-100): proprietary composite of disqualification, failed companies, concurrent appointments, Gazette warnings, filing compliance
- •Disqualification check: whether the director is currently disqualified with case details
- •Full appointment history: every company with role, status, appointment and resignation dates
- •Portfolio summary: active vs resigned appointments, dissolved vs active companies
- •Gazette notices: insolvency, winding-up, and striking-off notices mentioning the director (standard+ depth)
Data Sources
Companies House
Officer search across 5M+ UK companies. Appointment history, company status, filing compliance, and disqualified directors register. The authoritative source for UK corporate officer data.
The Gazette
The UK's official public record since 1665. Publishes statutory notices including winding-up petitions, striking-off notices, and personal insolvency proceedings linked to company directors.
Scoring Algorithm
Director Risk Score
Weighted composite: disqualification status (instant critical), failed companies in network (25%), concurrent directorships (15%), Gazette warning notices (20%), portfolio filing compliance (15%), director churn (10%). A disqualified director scores 100 automatically.
Use Cases
B2B Credit Vetting
Credit teams vet company directors before extending payment terms. A director with 5 dissolved companies and Gazette warnings is a different risk to one with a clean portfolio. The Risk Score quantifies what manual Companies House research takes hours to assess.
Angel Investment Due Diligence
Investors evaluate founders before committing capital. The appointment history reveals whether a founder has a track record of building companies or a pattern of dissolving them. The disqualification check catches red flags that a pitch deck won't disclose.
Franchise Operator Vetting
Franchise networks vet applicants for new territories. The Director Risk Score screens potential franchisees at scale — a single API call per applicant replaces days of manual background checking.
Investigative Research
Journalists and anti-fraud analysts map director networks to identify shell company patterns. The full appointment history with company statuses reveals connections that manual research would miss.
Example
Request
curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://www.ukdatapi.com/api/v1/director/Ken%20Murphy?depth=standard"
Response
{
"data": {
"director": { "name": "KEN MURPHY", "officer_id": "jM0YNnhv3hA0G3XbQMOL_g", "total_appointments": 8 },
"risk_score": {
"score": 8,
"rating": "LOW_RISK",
"signals": [],
"recommendation": "Low risk. Director has a clean track record across their company portfolio."
},
"disqualification": { "is_disqualified": false, "disqualifications": [] },
"portfolio_summary": { "active_appointments": 3, "resigned_appointments": 5, "dissolved_companies": 1, "active_companies": 3 },
"appointments": [
{ "company_name": "TESCO PLC", "company_status": "active", "role": "director", "is_active": true }
]
}
}Pricing
| Depth | Credits |
|---|---|
| Summary | 5 |
| Standard | 15 |
| Full | 30 |
Related Endpoints
GET /api/v1/entity/{identifier}
UK Company Intelligence API
Access 5M+ UK companies via API. Get officers, PSCs, filings, charges, regulatory status, and proprietary Corporate Distress Score (0-100). From £0.002/call.
GET /api/v1/report/entity/{identifier}
UK Due Diligence Report API
Automated company due diligence: PROCEED, CAUTION, or DO NOT ENGAGE verdict with red/green flags, distress scoring, and actionable recommendations.
GET /api/v1/legal/{query}
UK Legal API
UK legislation API: search Acts of Parliament, Statutory Instruments, and pending bills. legislation.gov.uk and Parliament data in one call.