Changelog

Fixed stale submitted phone numbers and email addresses after an update

The submitted object on a Business reflects phone numbers and email addresses sent on a later PATCH /v1/businesses/{id}. Previously submitted.phone_numbers and submitted.email_addresses kept the values from business creation, so a business updated with a new number or address still reported the original one. No integration changes are required. View the Business object reference.

Added International Business Verification

Middesk verifies businesses registered outside the United States and returns their registrations in the same format used for US Secretary of State data. Add an international_business_verification order when you create a business, optionally supply known registration numbers in the registrations array, and use POST /v1/businesses/{id}/registrations to add a registration to an existing business. Available to accounts with International Business Verification enabled. View the international verification guide.

Added Risk Assessment response schemas

The Risk Assessments API now documents the full assessment response, including dimensions, identifier_assessments, score, level, title, description_markdown, and the business snapshot link. Use the guide to retrieve the scored assessment behind a Business risk verdict. View Risk Assessment API guide.

Added jurisdiction validation to lien filing requests

Lien filing requests now reject unsupported jurisdictions before submission. Use the credit product jurisdiction coverage guide to confirm where lien filing, lien search, bankruptcy, litigation, criminal, and tax lien products are supported. View jurisdiction coverage.

Added webhook event schemas for business webhook payloads

Webhook event schemas let you configure which fields Middesk sends in the data.object of business webhook events while preserving the existing event envelope. Use the API or Dashboard schema builder to create, validate, and preview schemas before saving. View webhook guide.

Deprecated: orders[].package field

The orders[].package field is deprecated in favor of orders[].product. Requests that include orders[].package will continue to work but will return a deprecation warning in the response. Update your integration to use orders[].product, as orders[].package will be removed in a future release.

Enhanced Sandbox Preview

New enhanced sandbox mode available in Technology Preview. Define custom test businesses and use pre-built scenario templates to simulate specific verification outcomes directly from the Dashboard. Request access or view the enhanced sandbox guide.

Agents API

New API to retrieve specific agent details or a list of available agents on your account. Each agent has a defined type and set of capabilities for resolving business verification signals. View API reference.

Threads API

New API to create and manage agent threads. A thread holds context and history for agent work, typically associated with a business_id. Use threads to maintain state across multiple agent runs for the same Business. View API reference.

Autocomplete API

New Autocomplete API returns real-time, structured business suggestions based on partial name input—including names, addresses, people, and entity type. Integrate directly into your frontend to help users quickly find and select businesses during onboarding. View integration guide.

Smart populate API

GraphQL Preview

New GraphQL API available in Technology Preview. Query business verification data with nested relationships in a single request, reducing typical workflows from 3-5 sequential calls to one declarative query. Request access or view the GraphQL API reference.