Submit a KYB business verification order via Middesk and handle async webhook resolution

domain: docs.middesk.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. POST https://api.middesk.com/v1/businesses with body {name, addresses:[{address_line1, city, state, postal_code}], tin, people:[{name, title}]} and Authorization: Bearer YOUR_TOKEN
  2. Receive synchronous response with business.id and status: 'pending'; store id for correlation
  3. Register a webhook endpoint via Middesk dashboard or POST https://api.middesk.com/v1/webhooks with {url, events:['business.updated']}
  4. On receipt of POST from Middesk, parse event.type=='business.updated' and event.data.status; map 'approved', 'in_review', or 'rejected' to your workflow state
  5. If status is 'in_review', poll GET https://api.middesk.com/v1/businesses/{id} at intervals until terminal status or analyst resolution
  6. Extract event.data.watchlist.hit, event.data.registration.status, and event.data.tin.tin_type fields to build compliance record

Known gotchas

Related routes

verify a business (KYB) with the Middesk API
middesk.com · 6 steps · unrated
Verify a business entity using Middesk's business verification (KYB) API
docs.middesk.com · 6 steps · unrated
Register and verify a webhook endpoint to receive WHCC order status updates
whcc.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans