KYB Agent API

Reprompt agent generates a deep research KYB PDF report and JSON output including risk assessment, executive summary, and individual risk flags.

How It Works

Inputs: A business name and address. Optionally, the name of the person requesting the report and a tax identification number (EIN).

Processing: The agent autonomously researches the business across Secretary of State filings, IRS records, USPS address validation, watchlist databases, and the open web. Reports typically complete in under 3 minutes.

Output: A structured report with:

• Business status — Verified or unverified
• Executive summary — Key findings at a glance, designed for fast decisioning without reviewing the full report
• Risk scores — Fraud safety, loan approval, and Reprompt validation scores

And detailed verification across:

• Entity verification — Business name, address, source classification
• Core business facts — Formation state, entity type, formation date, filing ID, SOS standing, TIN match status
• Address verification — USPS deliverability, property type, CMRA, vacancy, risk level
• Secretary of State filings — Active/inactive registrations, standing, jurisdiction, registered agent
• Insights — Per-section status rollups
• Business names — Legal name and DBA names found across sources
• Online presence — Active websites and social media profiles
• People — Officers with roles
• Watchlist screening — Company and person screening results
• News and adverse media — Recent news coverage and adverse media mentions
• Certifications — Industry certifications including non-government associations

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": "Connex Solutions LLC",
    "business_address": "4015 Travis Dr Ste 211, Nashville, TN 37211-3742",
    "tax_identification_number": "33-3059213"
  }'

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

Use report_id to poll for results. For real-time progress, subscribe to the Pusher channel using stream_id and event_name.

Poll for Results

GET /kyb/report/{report_id}

curl "https://api.reprompt.io/kyb/report/rpt_7f3a2b1c9d4e" \
  -H "Authorization: Bearer YOUR_API_KEY"

The response shape depends on the status field: processing, completed, or error.

When status is completed, the response includes the full report object and a pdf_url linking to a permanent PDF.

What the Report Covers

Report Sections

Scores

Insights

Per-section status rollups. Each key maps to { "status": string }.

Error Response

{
  "status": "error",
  "report_id": "rpt_9x8c7d6e5f4a",
  "created_at": "2026-02-23T10:30:00Z",
  "error_at": "2026-02-23T10:31:12Z",
  "business_name": "Nonexistent Corp",
  "business_address": "123 Fake St, Nowhere, XX 00000",
  "error": "Unable to verify business entity. No matching records found in any data source."
}