Run a Persona business report to retrieve SOS filing data and UBO structure for a known entity

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

Steps

  1. POST https://withpersona.com/api/v1/reports with body {data:{type:'report/business-kyb', attributes:{reference_id:'your-ref', fields:{business_name:'Acme Corp', business_ein:'YOUR_EIN', address_street:'123 Main St', address_city:'Springfield', address_state:'IL'}}}}
  2. Poll GET https://withpersona.com/api/v1/reports/{report-id} until attributes.status changes from 'pending' to 'ready'
  3. Parse attributes.result.business_registration for SOS status, formation date, registered state, and registered agent
  4. Inspect attributes.result.associated_people for UBO names, ownership percentages, and individual verification statuses
  5. Check attributes.result.watchlists for OFAC and PEP hits across business and all listed owners
  6. Store report-id with your business record for future re-runs or audit retrieval

Known gotchas

Related routes

Build a KYB beneficial ownership lookup using the OpenCorporates API to retrieve registered officers and UBO structure
api.opencorporates.com · 5 steps · unrated
Initiate a Persona KYB transaction for a business entity and its beneficial owners via the Transactions API
docs.withpersona.com · 6 steps · unrated
Search U.S. business entity records via Secretary of State APIs and OpenCorporates
opencorporates.com · 6 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