Update Business Status
Flip only the lifecycle status of a business — VendorBusinessStatusChoices (ACTIVE/FLAGGED/BLOCKED, NOT session statuses). BLOCKED adds vendor_data to the system blocklist.
Overview
Moves a Business entity betweenACTIVE, FLAGGED, and BLOCKED. See entity lifecycle for the full state machine.
When to use it
- Block a sanctioned or confirmed-fraudulent business.
- Flag a business pending manual review.
- Unblock after remediation.
- Propagate external signals from your own compliance systems.
Notes
- Valid values:
ACTIVE,FLAGGED,BLOCKED. - Passing a
reasonstring is recommended — it is persisted and surfaced in the audit log and webhook payload. BLOCKEDbusinesses have all new Business Verification (KYB) sessions auto-declined and all new transactions auto-declined, including when they appear as counterparty.- Emits
business.status.updatedwithprevious_status,status, andreason.
Enforcement
Permissions
Role must grantupdate-status:businesses.
Related
Authorizations
Path Parameters
Your unique identifier for the business (free-form string, NOT a UUID).
Body
New lifecycle status. BLOCKED also adds the vendor_data to the system blocklist.
ACTIVE, FLAGGED, BLOCKED Response
Business status updated. Full business record returned.
Full business detail. Extends BusinessListItem with metadata and updated_at.
Didit's stable internal UUID for this business.
Your unique identifier for this business (passed when creating sessions). This can be null when no vendor identifier was supplied.
Custom display name set by you
Official legal name from registry or manual entry
Company registration or incorporation number
Country of incorporation (ISO 3166-1 alpha-2, e.g. GB, US).
Best available name: display_name if set, otherwise legal_name
Lifecycle status of the business record (NOT a session status). ACTIVE is the default, FLAGGED marks it for manual attention, BLOCKED prevents new sessions for this vendor_data.
ACTIVE, FLAGGED, BLOCKED Total number of verification sessions for this business
Number of approved sessions
Number of declined sessions
Number of sessions in review
Aggregated per-feature status across all of this business's KYB sessions. Currently the only key is KYB (the registry company check status). Possible values: Approved, Declined, In Review, Not Finished, Resub Requested.
Same data as features, as an ordered array of {feature, status} objects.
Timestamp of the most recent session
Timestamp of the first session
Timestamp of the most recent activity (status change, session update, etc.)
Tags assigned to this business
Custom metadata JSON you attached to this business. Defaults to {}.