UK KYB API

Know Your Business (KYB) is the process of verifying that a company is legitimate and safe to transact with. It is a standard requirement for onboarding in financial services, lending, partnerships, and regulated industries.

The Reprompt UK KYB API automates this end-to-end for companies registered in the United Kingdom.

How It Works

Inputs: A company name and address. Optionally, the name of the person requesting the report and a tax identification number.

Processing: The agent autonomously researches the business across UK government registries, global sanctions and PEP databases, address verification services, and the open web. Reports typically complete in under 3 minutes.

Output: A structured report covering:

• Identity verification — Company registration status, entity type, incorporation date, jurisdiction, and SIC codes
• Address verification — Registered address validation with precision level and red flags
• Officers and directors — Current and former directors, secretaries, and other officers
• Beneficial owners — Persons with Significant Control (PSCs) holding 25%+ ownership or voting rights
• Filing health — Whether statutory accounts and confirmation statements are current or overdue
• Charges — Outstanding loans, mortgages, and debentures registered against the company
• Sanctions and PEP screening — Each entity screened against global sanctions and PEP databases
• Web intelligence — Adverse media and relevant web coverage

Every report includes a risk score (0-100) with a clear recommendation (pass, review, enhanced due diligence, or fail), and an executive summary of 3 to 5 key findings.

API Reference

Base URL: https://api.reprompt.io

Authentication: Bearer token via Authorization header.

Start a Report

POST /kyb/report/start

curl -X POST "https://api.reprompt.io/kyb/report/start" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "business_name": "Revolut Ltd",
    "business_address": "7 Westferry Circus, Canary Wharf, London, E14 4HD"
  }'

{
  "status": "processing",
  "report_id": "rpt_7f3a2b1c9d4e",
  "poll_url": "/kyb/report/rpt_7f3a2b1c9d4e",
  "stream_id": "rpt_7f3a2b1c9d4e",
  "channel": "rpt_7f3a2b1c9d4e",
  "event_name": "kyb:stream:event"
}

Risk Assessment

Every report includes a server-computed risk score from 0 to 100.

Risk Tiers

Risk Signals

Example

{
  "score": 55,
  "classification": "HIGH_RISK",
  "recommendation": "EDD",
  "signal_breakdown": [
    { "signal": "Address not verified", "points": 15, "triggered": true },
    { "signal": "Sanctions hit", "points": 50, "triggered": true },
    { "signal": "Overdue accounts", "points": 15, "triggered": false }
  ]
}

Executive Summary

The executive summary is the fastest way to understand a report. It contains 3 to 5 key findings, each with a severity indicator and plain-language explanation.

[
  {
    "icon": "critical",
    "tone": "red",
    "title": "Sanctions Match",
    "description": "Director Nikolay Storonsky matched on Ukraine NSDC sanctions list"
  },
  {
    "icon": "check",
    "tone": "green",
    "title": "Active & Compliant",
    "description": "Company is active with filings up to date"
  },
  {
    "icon": "warning",
    "tone": "yellow",
    "title": "Address Not Verified",
    "description": "Registered address could not be independently verified"
  }
]

Report Sections

Identity Verification

Officers

Beneficial Owners (PSCs)

Sanctions Screening