Connect your own Middesk account to run KYB (Know Your Business) verification end to end: create Businesses and Orders (identity, TIN, watchlist/sanctions, industry classification, web presence, risk), read Review/Review Tasks, timeline, signals, liens, Secretary of State registrations, TIN match, websites, and documents, set up ongoing Monitors and Monitor Events, register webhooks, run Entity Management payroll-tax registrations, and drive Middesk's AI verification Agents. Uses your own Middesk API key -- nothing is hosted or proxied by Imperal beyond the request itself.
connect_middeskreadConnect your own Middesk account by saving an API key for a chosen environment (sandbox or production), after checking it actually works.
disconnect_middeskwriteDisconnect a Middesk account: deletes the saved API key. Nothing in Middesk itself is changed.
list_connectionsreadList the connected Middesk accounts and whether each saved API key still works.
create_businesswriteCreate a new Business in Middesk to start KYB verification -- name plus optional TIN/address/website, and optionally kick off verification products (orders) immediately.
update_businesswriteUpdate selected fields of an existing Business (name/TIN/external_id/tags). Only given fields change.
get_businessreadRead one Business in full: verification status, TIN, tags, and its review id.
list_businessesreadList Businesses in the connected Middesk account, optionally filtered by verification status.
list_business_timelinereadRead the event timeline of one Business -- every status change and verification milestone in order.
create_orderwriteOrder one or more verification products (e.g. identity, tin, watchlist, industry_classification, web_presence, risk) against an existing Business.
get_orderreadRead one verification Order in full -- its status and which products were requested.
list_ordersreadList every verification Order placed against one Business.
get_reviewreadRead a Business's Review in full -- overall status plus every Review Task (category, key, and outcome) that fed into the verification decision.
list_review_insightsreadRead consolidated, human-readable Review Insights for a Business -- Middesk's own summarized findings across every verification category.
create_monitorwriteSubscribe a Business to ongoing monitoring -- Middesk continuously re-checks it for SOS deactivation, new watchlist/sanctions hits, and officer/registration changes after initial approval.
get_monitorreadRead a Business's Monitor status -- whether ongoing monitoring is currently active.
delete_monitordestructiveStop ongoing monitoring for a Business. Cannot be undone -- create_monitor again to resume.
list_monitor_eventsreadList events raised by ongoing monitoring for a Business -- e.g. a new watchlist hit or a Secretary of State status change detected after approval.
list_liensreadList UCC and tax liens filed against a Business -- filing type, status, filing number/date, and jurisdiction.
list_registrationsreadList Secretary of State business registrations for a Business across every state it's registered in -- status, entity type, and standing.
get_tinreadRead the TIN/EIN match result for a Business -- whether the tax ID matches IRS records, and the TIN type.
list_documentsreadList documents Middesk has collected or generated for a Business (e.g. Secretary of State filings, formation documents).
list_websitesreadList websites Middesk associated with a Business, with basic web-presence signals.
create_business_batchwriteSubmit several businesses to Middesk in one call (e.g. bulk-onboarding a portfolio of vendors), optionally kicking off the same verification products for every one of them.
get_business_batchreadRead one Business Batch's status -- which businesses it contains and whether processing is complete.
list_signalsreadList the raw risk signals Middesk has collected for a Business -- category, signal type, severity, and description behind each flag.
list_policy_resultsreadList automated ruleset/Policy decisions Middesk computed for a Business -- which policy fired and its outcome.
create_actionwriteManually trigger a Middesk action against a Business (e.g. force a re-verification) instead of waiting for scheduled monitoring.
create_webhookwriteRegister a new webhook endpoint so Middesk pushes verification lifecycle events (business updates, review completion, monitor hits) to your URL as they happen.
get_webhookreadRead one webhook subscription's full configuration by id.
list_webhooksreadList webhook subscriptions configured on the connected Middesk account.
update_webhookwriteChange an existing webhook's URL and/or subscribed event types. Only given fields change.
delete_webhookdestructivePermanently remove a webhook subscription. Cannot be undone.
create_registration_requestwriteCreate a payroll-tax Registration Request for a company in one or more jurisdictions (Entity Management -- separate from KYB Business Verification).
get_registration_requestreadRead one payroll-tax Registration Request in full -- status and which jurisdictions it covers.
list_registration_requestsreadList payroll-tax Registration Requests on the connected Middesk Entity Management account.
list_information_requestsreadList Information Requests Middesk raised while processing a Registration Request -- follow-up questions that need answers before the state application can be filed.
answer_information_requestwriteSubmit answers to an open Information Request so Middesk can continue filing the payroll-tax registration.
list_jurisdictionsreadList the state jurisdictions Middesk supports for payroll-tax registration.
list_mailreadList physical mail Middesk has received on your behalf from state agencies during a payroll-tax registration, optionally filtered to one Registration Request.
list_agentsreadList AI verification agents configured on the connected Middesk account.
create_agent_threadwriteStart a new conversation thread with a Middesk AI verification agent, optionally grounded on a specific Business.
get_agent_threadreadRead one agent conversation thread in full, including its recent runs.
run_agentwriteTrigger a run on an agent thread with an instruction -- the agent works the verification task and may pause at an interrupt policy step for human approval.
approve_agent_runwriteApprove or reject an agent run that is paused at a human-in-the-loop interrupt policy step, letting it proceed or stopping it.
autocomplete_identityreadGet business-identity autocomplete suggestions for a partial name/address -- for a fast, low-friction onboarding form before a full KYB order.
smart_populatewriteAuto-fill a full business profile from a partial input (e.g. just a name), so an onboarding form can be pre-filled before the user finishes typing.
run_risk_assessmentwriteRun a standalone, fast risk assessment on a business identity without opening a full Business Order -- useful for a quick pre-screen before deciding whether to run the full KYB flow.
audit_verification_portfolioreadValue-add report: scan recent Businesses in the connected Middesk account and flag ones stuck in_review, rejected, or with unresolved review tasks -- a one-glance KYB portfolio health check.
Install Middesk and let Webbee use it across your workflow.
Open in panel