> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.middesk.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.middesk.com/_mcp/server.

# Update a business

PATCH https://api.middesk.com/v1/businesses/{id}
Content-Type: application/json

Reference: https://docs.middesk.com/api-reference/business-verification/businesses/update-business

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Path parameters

- `id` (string, required) — Business ID

### Body (application/json)

This endpoint expects an object.

- `name` (string, optional)
- `status` (enum, optional) — Status to set for the business (only final statuses allowed)
  - Allowed values: `in_review`, `approved`, `rejected`
- `tin` (BusinessUpdateParamTin, optional)
- `addresses` (list of BusinessUpdateParamAddressesItem, optional)
- `website` (BusinessUpdateParamWebsite, optional) — Website information for the business. Sets the submitted website URL; ignored when it resolves to the same host as the business's existing website.
- `phone_numbers` (list of BusinessUpdateParamPhoneNumbersItem, optional) — Phone numbers to add to the business. Numbers that already exist on the business are ignored.
- `people` (list of SubmittedPerson, optional)
- `external_id` (string, optional)
- `unique_external_id` (string, optional)
- `tags` (list of string, optional)

## Response

### 200

business updated

- `object` (string, required)
- `id` (string, required)
- `name` (string, required)
- `status` (enum, required) — Current status of the business verification
  - Allowed values: `open`, `pending`, `in_audit`, `in_review`, `approved`, `rejected`
- `created_at` (datetime, required)
- `updated_at` (datetime, required)
- `external_id` (string, optional, nullable)
- `unique_external_id` (string, optional, nullable)
- `tags` (list of string, optional)
- `requester` (Requester, optional, nullable)
- `assignee_id` (string, optional, nullable)
- `supported_document_types` (list of enum, optional)
  - Allowed values: `Articles of Incorporation`, `Certificate of Good Standing`
- `review` (Review, optional, nullable)
- `tin` (Tin, optional, nullable)
- `business_batch_id` (string, optional, nullable)
- `formation` (Formation, optional, nullable)
- `website` (Website, optional, nullable)
- `watchlist` (Watchlist, optional, nullable)
- `risk` (BusinessRisk, optional, nullable) — Top-level risk outcome for the business. Populated once a Risk order reaches a terminal state (completed with a verdict, or unavailable). `null` while a Risk order is still in flight. This is the business-level risk outcome; granular per-resource assessments live on the Risk Assessment resource, not here.
- `bankruptcies` (list of Bankruptcy, optional)
- `certifications` (list of Certification, optional)
- `documents` (list of Document, optional)
- `liens` (list of Lien, optional)
- `names` (list of Name, optional)
- `addresses` (list of Address, optional)
- `people` (list of Person, optional)
- `phone_numbers` (list of PhoneNumber, optional)
- `email_addresses` (list of EmailAddress, optional)
- `profiles` (list of Profile, optional)
- `registrations` (list of Registration, optional)
- `orders` (list of Order, optional)
- `industry_classification` (IndustryClassification, optional, nullable)
- `monitor` (Monitor, optional, nullable)
- `tax_exempt_organization` (TaxExemptOrganization, optional, nullable)
- `fmcsa_registrations` (list of FmcsaRegistration, optional)
- `loans` (list of Loan, optional, nullable)
- `litigations` (list of Litigation, optional)
- `policy_results` (list of PolicyResult, optional)
- `politically_exposed_person_screening` (PoliticallyExposedPersonScreening, optional, nullable)
- `adverse_media_screening` (AdverseMediaScreening, optional, nullable)
- `signal` (Signal, optional, nullable)
- `submitted` (SubmittedAttribute, optional)
- `subscription` (Subscription, optional, nullable)
- `subscription_availability` (BusinessSubscriptionAvailability, optional, nullable)

## Errors

### 404 Update Business Request Not Found Error

business not found

- `errors` (list of ErrorResponseErrorsItem, required)

## Types

### BusinessUpdateParamTin

- `tin` (string, optional)

### BusinessUpdateParamAddressesItem

### BusinessUpdateParamWebsite

Website information for the business. Sets the submitted website URL; ignored when it resolves to the same host as the business's existing website.

- `url` (string, optional) — The website URL for the business

### BusinessUpdateParamPhoneNumbersItem

- `phone_number` (string, optional)

### SubmittedPerson

A person associated with the business. Provide a full `name`, or `first_name` and `last_name`. `people_ucc_liens` and `people_criminal_history` require `first_name` and `last_name`; other person products accept either.

- `name` (string, required) — Full name of the person
- `first_name` (string, optional) — The person's first (given) name.
- `middle_name` (string, optional) — The person's middle name.
- `last_name` (string, optional) — The person's last (family) name.
- `name_suffix` (string, optional) — Generational suffix for the person (for example `Jr`, `Sr`, or `III`). Used only to narrow `people_ucc_liens` searches by matching debtors whose name includes this suffix. It has no effect on any other order type.
- `title` (string, optional) — Job title or role
- `email` (string, optional)
- `phone` (string, optional)

### Requester

- `id` (string, required)
- `type` (enum, required)
  - Allowed values: `account`, `user`
- `name` (string, required)
- `requested_at` (datetime, required)

### Review

- `object` (enum, required)
  - Allowed values: `review`
- `id` (string, required)
- `created_at` (datetime, required)
- `updated_at` (datetime, required)
- `tasks` (list of ReviewTask, required)
- `completed_at` (datetime, optional, nullable)
- `analyst_read_markdown` (string, optional, nullable) — LLM-generated analyst read of the business's verification results, in CommonMark markdown: one lead sentence followed by up to five bullet findings. Inline links, when present, are dashboard-relative paths (for example /businesses/\{id}/registrations) and may be ignored by API consumers. Null until a read has been generated; generated only for businesses without a risk order, whose risk assessment carries its own read.
- `analyst_read_generated_at` (datetime, optional, nullable) — When the analyst read was delivered. Null until a read has been generated.
- `assignee` (User, optional, nullable)

### Tin

- `business_id` (string, required)
- `tin` (string, required)
- `name` (string, optional, nullable)
- `mismatch` (boolean, optional)
- `unknown` (boolean, optional)
- `verified` (boolean, optional, nullable)
- `error` (string, optional, nullable)
- `updated_at` (datetime, optional)
- `issued` (boolean, optional, nullable)
- `verified_by` (string, optional, nullable)

### Formation

- `created_at` (datetime, required)
- `updated_at` (datetime, required)
- `entity_type` (string, optional)
- `formation_date` (date, optional)
- `formation_state` (string, optional)
- `sources` (list of Source, optional)

### Website

- `object` (enum, required)
  - Allowed values: `website`
- `id` (string, required)
- `url` (string, required, nullable) — The URL that was passed or found for the Business
- `created_at` (datetime, required)
- `updated_at` (datetime, required)
- `status` (enum, required)
  - Allowed values: `online`, `offline`, `unknown`
- `parked` (boolean, required, nullable) — Whether the domain is parked
- `submitted` (boolean, required) — Whether the website was submitted by user
- `business_id` (string, required)
- `business_name_match` (boolean, required) — Whether website content matches business name
- `phone_numbers` (list of WebsitePhoneNumber, required) — Phone numbers found on website
- `addresses` (list of WebsiteAddressesItem, required) — Addresses found on website
- `http_status_code` (integer, optional, nullable) — HTTP response status code
- `title` (string, optional, nullable) — Website page title
- `description` (string, optional, nullable) — Website meta description
- `domain` (WebsiteDomain, optional, nullable) — Domain registration and redirect information
- `pages` (list of WebsitePagesItem, optional) — Website pages with screenshots
- `error` (string, optional, nullable) — Error message if website analysis failed
- `category` (string, optional, nullable) — Website category classification
- `platform` (string, optional, nullable) — Website platform (e.g., instagram.com, facebook.com)
- `posts_summary` (string, optional, nullable) — Summary of posts found on the website or linked social media profiles
- `reviews_summary` (string, optional, nullable) — Summary of reviews found on the website or linked third-party profiles
- `names` (list of Name, optional) — Names found on website
- `people` (list of map from string to any, optional, nullable) — People found on website
- `email_addresses` (list of WebsiteEmailAddressesItem, optional, nullable) — Email addresses found on website
- `rating` (WebsiteRating, optional, nullable)

### Watchlist

- `object` (string, required)
- `id` (string, required)
- `hit_count` (integer, required)
- `agencies` (list of WatchlistAgency, required)
- `lists` (list of WatchlistSource, required)
- `people` (list of map from string to any, required)

### BusinessRisk

Terminal outcome of a Risk order on the business. `status: completed` carries a verdict (`level`); `status: unavailable` means the run stopped in a failure state and produced no verdict, with a `reason`. Null while a run is in flight.

- `object` (enum, required) — The resource type, always `risk`.
  - Allowed values: `risk`
- `status` (enum, required) — Whether the Risk order produced a verdict or stopped unavailable.
  - Allowed values: `completed`, `unavailable`
- `level` (enum, optional) — Categorical risk verdict, present when `status` is `completed`. `not_available` means the run completed but could not produce a conclusive verdict (e.g. an unassessable profile) — distinct from `unavailable`.
  - Allowed values: `low`, `moderate`, `high`, `not_available`
- `score` (integer, optional) — Integer 0-100 risk score, present when `status` is `completed` and the assessment carries a score. `level` is banded from it.
- `latest_assessment_id` (string, optional) — Id of the Risk Assessment resource, present when `status` is `completed`.
- `reason` (string, optional) — Why no verdict was produced, present when `status` is `unavailable`.

### Bankruptcy

- `object` (enum, required)
  - Allowed values: `bankruptcy`
- `id` (string, required)
- `business_id` (string, required)
- `case_number` (string, required)
- `case_updates` (list of BankruptcyCaseUpdatesItem, required)
- `chapter` (double, required)
- `court` (string, required)
- `filing_date` (date, required, nullable)
- `debtors` (list of BankruptcyDebtorsItem, required)

### Certification

- `object` (enum, required)
  - Allowed values: `certification`
- `name` (string, required)
- `key` (string, required)
- `certification_type` (enum, required)
  - Allowed values: `federal`, `self_certified`
- `external_sources` (list of CertificationExternalSourcesItem, required)
- `id` (string, optional)
- `business_id` (string, optional)
- `created_at` (datetime, optional)
- `updated_at` (datetime, optional)
- `entrance_date` (datetime, optional, nullable)
- `exit_date` (datetime, optional, nullable)
- `certification_id` (string, optional, nullable)

### Document

- `object` (enum, required)
  - Allowed values: `document`
- `id` (string, required)
- `document_type` (string, required) — Type of document. Common values include: Initial_Filing, Certificate of Good Standing, Articles of Incorporation, Initial Filing (UCC1), Amendment (UCC3)
- `filename` (string, required) — Name of the document file
- `content_type` (string, required) — MIME type of the document
- `size` (integer, required) — File size in bytes
- `download_url` (string, required) — URL to download the document
- `created_at` (datetime, required)
- `source` (DocumentSource, optional)
- `filing_date` (datetime, optional, nullable)
- `metadata` (map from string to any, optional) — Additional document metadata

### Lien

- `object` (enum, required)
  - Allowed values: `lien`
- `type` (enum, required) — Type of lien
  - Allowed values: `ucc`, `state`, `federal`, `attachment`, `judgment`
- `id` (string, required)
- `business_id` (string, required)
- `debtors` (list of LienDebtorsItem, required)
- `secured_parties` (list of LienSecuredPartiesItem, required)
- `file_number` (string, required, nullable) — Filing number for the lien
- `state` (enum, required) — State where the lien was filed
  - Allowed values: `AL`, `AK`, `AZ`, `AR`, `CA`, `CO`, `CT`, `DE`, `FL`, `GA`, `HI`, `ID`, `IL`, `IN`, `IA`, `KS`, `KY`, `LA`, `ME`, `MD`, `MA`, `MI`, `MN`, `MS`, `MO`, `MT`, `NE`, `NV`, `NH`, `NJ`, `NM`, `NY`, `NC`, `ND`, `OH`, `OK`, `OR`, `PA`, `RI`, `SC`, `SD`, `TN`, `TX`, `UT`, `VT`, `VA`, `WA`, `WV`, `WI`, `WY`
- `status` (enum, required) — Current status of the lien
  - Allowed values: `created`, `pending`, `open`, `closing`, `closed`, `unknown`, `filed`, `failed`
- `filing_date` (date, required, nullable) — Date the lien was filed
- `status_category` (enum, required) — Categorized status of the lien
  - Allowed values: `active`, `open`, `closed`, `terminated`, `processing`, `unknown`, `failed`
- `owner_id` (string, required) — Polymorphic owner ID (typically business_id)
- `owner_type` (string, required) — Polymorphic owner type (typically Business)
- `documents` (list of Document, required) — Associated lien documents
- `updated_date` (date, optional, nullable) — Date the lien was last updated
- `lapse_date` (date, optional, nullable) — Date the lien lapses/expires
- `collateral` (string, optional, nullable) — Description of collateral securing the lien
- `collateral_type` (enum, optional, nullable) — Type of collateral
  - Allowed values: `Blanket`, `Collateral`, `Unknown`, `All Assets and Receivables`, `All Receivables`, `All Assets`, `Named Assets`, `Unavailable`
- `negative_pledge` (boolean, optional) — Whether this is a negative pledge
- `confirmation_number` (string, optional, nullable)
- `loan_principal_amount_cents` (integer, optional, nullable) — Loan principal amount in cents
- `source` (string, optional, nullable) — Source URL for the lien data
- `packet_number` (string, optional, nullable)
- `lien_termination` (map from string to any, optional, nullable) — Lien termination details if terminated
- `liability_cents` (integer, optional, nullable) — Liability amount in cents
- `alternative_designation` (enum, optional, nullable)
  - Allowed values: `buyer_seller`, `bailee_bailor`, `consignee_consignor`, `lessee_lessor`, `licensee_licensor`
- `filed_by_account` (boolean, optional, nullable) — Whether the lien was filed by the account

### Name

- `object` (string, required)
- `id` (string, required)
- `name` (string, required)
- `submitted` (boolean, required)
- `business_id` (string, required)
- `sources` (list of Source, required)
- `type` (enum, optional, nullable)
  - Allowed values: `legal`, `dba`

### Address

- `object` (string, required)
- `id` (string, required)
- `full_address` (string, required)
- `submitted` (boolean, required)
- `created_at` (datetime, required)
- `updated_at` (datetime, required)
- `business_id` (string, required)
- `sources` (list of Source, required)
- `rating` (AddressRating, required)
- `address_line1` (string, optional, nullable)
- `address_line2` (string, optional, nullable)
- `city` (string, optional, nullable)
- `state` (enum, optional, nullable)
  - Allowed values: `AL`, `AK`, `AZ`, `AR`, `CA`, `CO`, `CT`, `DE`, `FL`, `GA`, `HI`, `ID`, `IL`, `IN`, `IA`, `KS`, `KY`, `LA`, `ME`, `MD`, `MA`, `MI`, `MN`, `MS`, `MO`, `MT`, `NE`, `NV`, `NH`, `NJ`, `NM`, `NY`, `NC`, `ND`, `OH`, `OK`, `OR`, `PA`, `RI`, `SC`, `SD`, `TN`, `TX`, `UT`, `VT`, `VA`, `WA`, `WV`, `WI`, `WY`
- `postal_code` (string, optional, nullable)
- `latitude` (double, optional, nullable)
- `longitude` (double, optional, nullable)
- `property_type` (enum, optional, nullable)
  - Allowed values: `commercial`, `residential`
- `deliverable` (boolean, optional)
- `deliverability_analysis` (AddressDeliverabilityAnalysis, optional, nullable)
- `street_view_available` (boolean, optional, nullable)
- `labels` (list of string, optional)
- `references` (list of string, optional) — References submitted by the customer for this address. Only present when the customer submitted a reference; collapsed duplicate addresses include every submitted key.
- `registered_agent_name` (string, optional, nullable)
- `cmra` (boolean, optional)
- `location_count` (integer, optional, nullable)
- `is_registered_agent` (boolean, optional, nullable)

### Person

- `object` (enum, optional)
  - Allowed values: `person`
- `id` (string, optional)
- `name` (string, optional)
- `submitted` (boolean, optional)
- `business_id` (string, optional)
- `titles` (list of PersonTitlesItem, optional)
- `people_bankruptcies` (list of map from string to any, optional)
- `litigations` (list of Litigation, optional)
- `liens` (list of Lien, optional)
- `criminal_records` (list of CriminalHistoryRecord, optional)
- `sources` (list of Source, optional)

### PhoneNumber

- `object` (enum, optional)
  - Allowed values: `phone_number`
- `id` (string, optional) — Unique identifier for the phone number resource.
- `number` (string, optional)
- `contact_type` (string, optional, nullable)
- `recommended` (boolean, optional, nullable)

### EmailAddress

- `object` (enum, required)
  - Allowed values: `email_address`
- `id` (string, required)
- `email` (string, required)
- `submitted` (boolean, required)
- `sources` (list of Source, optional)
- `domain` (string, optional) — Domain portion of the email address. Included when email risk data is present.
- `valid` (boolean, optional) — Whether the email address is valid. Included when email risk data is present.
- `deliverability` (string, optional) — Likelihood that mail sent to this address will be delivered. Included when email risk data is present.
- `disposable` (boolean, optional) — Whether the email belongs to a disposable / temporary email service. Included when email risk data is present.
- `address_type` (enum, optional) — Classification of the email address. Included when email risk data is present.
  - Allowed values: `disposable`, `free`, `private`
- `business_id` (string, optional) — ID of the business the email address is associated with. Included when email risk data is present.
- `domain_age` (datetime, optional, nullable) — UTC datetime the email's domain was first registered. Included when email risk data is present.
- `first_seen` (datetime, optional, nullable) — UTC datetime the email was first observed by our data provider. Included when email risk data is present.
- `rating` (EmailRating, optional)

### Profile

- `object` (string, required)
- `id` (string, required)
- `type` (enum, required)
  - Allowed values: `facebook`, `google`, `yelp`, `bbb`, `linkedin`
- `url` (string, required)
- `external_id` (string, optional, nullable)
- `metadata` (ProfileMetadata, optional)
- `rating` (double, optional, nullable)
- `rating_count` (integer, optional, nullable)

### Registration

- `object` (string, required)
- `id` (string, required)
- `business_id` (string, required)
- `name` (string, required)
- `status` (string, required)
- `jurisdiction` (string, required, nullable) — Indicates the relationship between the business and this jurisdiction. `DOMESTIC` or `FOREIGN` for US registrations; `HOME` or `EXTRA_PROVINCIAL` for Canada; `UNKNOWN` when undetermined; `null` for other international registrations.
- `entity_type` (string, required, nullable)
- `file_number` (string, required)
- `state` (enum, required, nullable) — The US state for the registration. `null` for international registrations.
  - Allowed values: `AL`, `AK`, `AZ`, `AR`, `CA`, `CO`, `CT`, `DE`, `FL`, `GA`, `HI`, `ID`, `IL`, `IN`, `IA`, `KS`, `KY`, `LA`, `ME`, `MD`, `MA`, `MI`, `MN`, `MS`, `MO`, `MT`, `NE`, `NV`, `NH`, `NJ`, `NM`, `NY`, `NC`, `ND`, `OH`, `OK`, `OR`, `PA`, `RI`, `SC`, `SD`, `TN`, `TX`, `UT`, `VT`, `VA`, `WA`, `WV`, `WI`, `WY`
- `sub_status` (string, optional, nullable)
- `status_details` (string, optional, nullable)
- `jurisdiction_details` (RegistrationJurisdictionDetails, optional, nullable) — The sub-national jurisdiction for international registrations. `null` for US registrations.
- `country_code` (string, optional) — `US` for domestic registrations, or an ISO 3166-1 alpha-2 code for international registrations (e.g., `FR`, `DE`, `GB`).
- `addresses` (list of string, optional)
- `officers` (list of map from string to any, optional)
- `registered_agent` (map from string to any, optional, nullable)
- `registration_date` (date, optional, nullable)
- `source` (string, optional, nullable)
- `submitted` (boolean, optional) — `true` if you submitted the registration, `false` if Middesk sourced it.

### Order

- `object` (string, required)
- `id` (string, required)
- `status` (enum, required)
  - Allowed values: `created`, `pending`, `audited`, `completed`, `approved`, `rejected`
- `business_id` (string, required)
- `product` (enum, required)
  - Allowed values: `identity`, `liens`, `adverse_media`, `bankruptcies`, `business_enrichment`, `documents`, `enhanced_screenings`, `kyc`, `litigations`, `people_litigations`, `people_bankruptcies`, `people_tax_liens`, `people_ucc_liens`, `people_criminal_history`, `tin`, `website`, `business_verification_qualify`, `business_verification_verify`, `tax_liens`, `ucc_liens`, `email_risk`
- `created_at` (datetime, required)
- `updated_at` (datetime, required)
- `subproducts` (list of enum, optional)
  - Allowed values: `Articles of Incorporation`, `Certificate of Good Standing`, `Articles of Incorporation with Certificate of Good Standing fallback`, `ucc_documents`, `web_analysis`, `industry_classification`
- `completed_at` (datetime, optional, nullable)
- `monitoring` (boolean, optional)
- `requester` (OrderRequester, optional)

### IndustryClassification

- `object` (enum, required)
  - Allowed values: `industry_classification`
- `id` (string, required)
- `status` (enum, required)
  - Allowed values: `pending`, `completed`, `failed`
- `categories` (list of IndustryClassificationCategoriesItem, required)
- `created_at` (datetime, required)
- `completed_at` (datetime, optional, nullable)
- `website` (IndustryClassificationWebsite, optional, nullable)

### Monitor

- `object` (string, required)
- `id` (string, required)
- `created_at` (datetime, required)
- `event_types` (list of MonitorEventTypesItem, required)

### TaxExemptOrganization

- `object` (string, optional)
- `id` (string, optional)
- `ein` (string, optional)
- `name` (string, optional)
- `section` (string, optional, nullable)
- `ruling_date` (date, optional, nullable)
- `tax_period` (date, optional, nullable)
- `revoked_at` (datetime, optional, nullable)

### FmcsaRegistration

- `object` (enum, required)
  - Allowed values: `fmcsa_registration`
- `id` (string, required)
- `dot_number` (string, required) — Department of Transportation (DOT) number
- `legal_name` (string, required) — Legal name of the carrier
- `source` (string, required) — Source URL for the FMCSA registration data
- `addresses` (list of string, required) — List of carrier addresses
- `dba_name` (string, optional, nullable) — Doing Business As name

### Loan

- `object` (enum, required)
  - Allowed values: `loan`
- `id` (string, required)
- `issued_date` (date, optional, nullable)
- `amount` (double, optional, nullable)
- `lender` (string, optional, nullable)
- `details` (LoanDetails, optional, nullable)

### Litigation

- `object` (string, required)
- `id` (string, required)
- `case_name` (string, required)
- `case_number` (string, required)
- `case_status` (enum, required)
  - Allowed values: `OPEN`, `CLOSED`, `UNKNOWN`
- `case_type` (string, required)
- `filing_date` (date, required)
- `party_type` (string, required)
- `judgments` (list of Judgment, optional)
- `jurisdiction` (string, optional)
- `jurisdiction_state` (string, optional, nullable)
- `parties` (list of LitigationPartiesItem, optional)

### PolicyResult

- `object` (string, optional)
- `id` (string, optional) — Policy result ID
- `result` (string, optional) — Policy result outcome
- `created_at` (string, optional) — Creation timestamp
- `matched` (string, optional, nullable) — Match status
- `executed` (boolean, optional) — Execution status
- `name` (string, optional, nullable) — Policy name
- `details` (map from string to any, optional) — Additional details
- `owner_id` (string, optional) — Owner ID
- `owner_type` (string, optional) — Owner type
- `business_id` (string, optional) — Business ID
- `type_of` (string, optional) — Type of policy result
- `policy_action_results` (list of PolicyActionResult, optional)

### PoliticallyExposedPersonScreening

- `object` (string, required)
- `id` (string, required)
- `created_at` (datetime, required)
- `updated_at` (datetime, required)
- `results` (list of PoliticallyExposedPersonScreeningResultsItem, required)
- `settings` (PoliticallyExposedPersonScreeningSettings, optional)

### AdverseMediaScreening

- `object` (string, required)
- `id` (string, required)
- `created_at` (datetime, required)
- `updated_at` (datetime, required)
- `results` (list of AdverseMediaScreeningResultsItem, required)
- `exclusion_settings` (AdverseMediaScreeningExclusionSettings, optional)

### Signal

- `object` (string, required)
- `id` (string, required)
- `name` (string, required)
- `created_at` (datetime, required)
- `tin` (string, optional, nullable)
- `external_id` (string, optional, nullable)
- `model_slug` (string, optional)
- `score` (double, optional, nullable)
- `business_id` (string, optional, nullable)
- `batch_id` (string, optional, nullable)
- `requester` (SignalRequester, optional)
- `reasons` (list of SignalReasonsItem, optional)
- `addresses` (list of string, optional)
- `people` (list of string, optional)

### SubmittedAttribute

- `object` (string, required)
- `name` (string, required)
- `name_derived` (boolean, optional)
- `entity_type` (string, optional, nullable)
- `addresses` (list of map from string to any, optional)
- `orders` (list of SubmittedAttributeOrdersItem, optional, nullable)
- `people` (list of map from string to any, optional)
- `phone_numbers` (list of map from string to any, optional, nullable)
- `email_addresses` (list of map from string to any, optional, nullable)
- `tags` (list of string, optional, nullable)
- `external_id` (string, optional, nullable)
- `unique_external_id` (string, optional, nullable)
- `tin` (map from string to any, optional, nullable)
- `website` (map from string to any, optional, nullable)
- `assignee_id` (string, optional, nullable)
- `formation` (map from string to any, optional, nullable)
- `names` (list of map from string to any, optional, nullable)
- `profiles` (list of map from string to any, optional, nullable)

### Subscription

- `object` (string, optional)
- `id` (string, optional)

### BusinessSubscriptionAvailability

- `bankruptcy` (enum, optional)
  - Allowed values: `subscribable`, `account_unsubscribable`
- `certification` (enum, optional)
  - Allowed values: `subscribable`, `account_unsubscribable`
- `registration` (enum, optional)
  - Allowed values: `subscribable`, `account_unsubscribable`
- `tin` (enum, optional)
  - Allowed values: `subscribable`, `account_unsubscribable`
- `watchlist_result` (enum, optional)
  - Allowed values: `subscribable`, `account_unsubscribable`
- `lien` (enum, optional)
  - Allowed values: `subscribable`, `account_unsubscribable`

### ErrorResponseErrorsItem

- `message` (string, required)
- `parameter` (string, optional) — Request parameter associated with the error, when applicable

### SubmittedAddressFull

- `full_address` (string, required) — Complete address as a single string
- `reference` (string, optional) — Optional, customer-supplied key to identify an address

### SubmittedAddressComponent

- `address_line1` (string, required)
- `city` (string, required)
- `state` (enum, required)
  - Allowed values: `AL`, `AK`, `AZ`, `AR`, `CA`, `CO`, `CT`, `DE`, `FL`, `GA`, `HI`, `ID`, `IL`, `IN`, `IA`, `KS`, `KY`, `LA`, `ME`, `MD`, `MA`, `MI`, `MN`, `MS`, `MO`, `MT`, `NE`, `NV`, `NH`, `NJ`, `NM`, `NY`, `NC`, `ND`, `OH`, `OK`, `OR`, `PA`, `RI`, `SC`, `SD`, `TN`, `TX`, `UT`, `VT`, `VA`, `WA`, `WV`, `WI`, `WY`
- `address_line2` (string, optional)
- `postal_code` (string, optional)
- `country` (string, optional)
- `reference` (string, optional) — Optional, customer-supplied key to identify an address

### ReviewTask

- `category` (enum, required)
  - Allowed values: `bankruptcies`, `global_watchlists`, `name`, `people_litigations`, `loans`, `kyc`, `watchlist`, `phone`, `formation`, `people_criminal_history`, `adverse_media`, `litigations`, `tin_type`, `address`, `sos`, `web`, `liens`, `people_bankruptcies`, `industry`, `tin`, `people`, `people_liens`, `website`, `politically_exposed_persons`, `email`
- `key` (enum, required)
  - Allowed values: `location_frequency`, `bankruptcies`, `sos_unknown`, `address_deliverability`, `website_url_discovery`, `entity_type`, `web_person_verification`, `global_watchlists`, `website_status`, `name`, `sos_sub_status`, `name_and_entity_type`, `sos_active`, `profile_status`, `phone`, `sos_domestic`, `address_high_risk`, `web_address_verification`, `address_property_type`, `sos_not_found`, `time_in_business`, `web_phone_number_verification`, `adverse_media`, `litigations`, `address_verification`, `people_litigations`, `dba_name`, `watchlist`, `entity_type_match`, `people_criminal_history`, `formation_state`, `tin_error`, `sos_inactive`, `address_frequency`, `web_business_name_verification`, `web_presence_quality`, `tin_type`, `tin_issued`, `sos_domestic_sub_status`, `risky_keywords`, `address_registered_agent`, `sos`, `kyc_decision`, `ppp_loans`, `web_email_address_verification`, `tin`, `address`, `liens`, `sos_status`, `industry`, `sos_match`, `address_risk`, `website_url_domain_ownership`, `website_parked`, `domain_redirect`, `people_bankruptcies`, `politically_exposed_persons`, `person_verification`, `profile_discovery`, `address_cmra`, `website_verification`, `website`, `people_liens`, `email_risk`
- `label` (enum, required)
  - Allowed values: `Politically Exposed Persons`, `Web Presence Quality`, `KYC`, `People Bankruptcies`, `Address Risk`, `Global Watchlists`, `Phone Number`, `Third Party Profile Status`, `Liens`, `Third Party Profiles`, `Time in Business`, `Web - Email Address`, `Risky Keywords`, `SOS Domestic Sub‑status`, `PPP Loans`, `Secretary of State Filings`, `Entity Type`, `SOS Filings`, `People Criminal History`, `Adverse Media`, `Web - People`, `Office Address`, `Entity Type Match`, `Web - Phone Number`, `Business Name`, `Bankruptcies`, `Industry Classification`, `TIN Match`, `Watchlists`, `People Litigations`, `True Industry`, `People`, `DBA Name`, `Domain Ownership`, `Domain Redirect`, `TIN Type`, `Website`, `TIN Error`, `Watchlist`, `Litigations`, `Web - Business Name`, `Name Entity Type`, `Formation State`, `People Liens`, `Web - Office Address`, `Email Risk`
- `message` (string, required)
- `name` (string, required)
- `status` (enum, required)
  - Allowed values: `success`, `failure`, `warning`, `neutral`
- `sub_label` (string, required)
- `sources` (list of Source, required)

### User

- `object` (string, required)
- `id` (string, required)
- `name` (string, required)
- `email` (string, required)
- `roles` (list of string, required)
- `created_at` (datetime, required)
- `image_url` (string, optional)
- `directory_managed` (boolean, optional)
- `last_login_at` (datetime, optional, nullable)
- `settings` (map from string to any, optional)

### Source

- `id` (string, required)
- `type` (string, required) — Origin of the resource. `risk_analysis` indicates the resource was discovered by a Risk order; for such sources, `id` is the originating risk_assessment ID.
- `metadata` (map from string to any, required)

### WebsitePhoneNumber

- `object` (enum, optional)
  - Allowed values: `phone_number`
- `id` (string, optional)
- `number` (string, optional)
- `contact_type` (string, optional, nullable)
- `recommended` (boolean, optional, nullable)
- `submitted` (boolean, optional)
- `sources` (list of Source, optional, nullable)

### WebsiteAddressesItem

- `object` (string, optional)
- `id` (string, optional)
- `address_line1` (string, optional, nullable)
- `address_line2` (string, optional, nullable)
- `city` (string, optional, nullable)
- `state` (string, optional, nullable)
- `postal_code` (string, optional, nullable)
- `full_address` (string, optional)
- `submitted` (boolean, optional)
- `sources` (list of Source, optional)

### WebsiteDomain

- `domain` (string, optional)
- `domain_id` (string, optional, nullable)
- `creation_date` (datetime, optional)
- `expiration_date` (datetime, optional)
- `registrar` (WebsiteDomainRegistrar, optional)
- `redirected` (boolean, optional, nullable) — Whether the domain redirects to a different URL
- `url_shortener` (boolean, optional, nullable) — Whether the domain uses a URL shortener service
- `resolved_url` (string, optional, nullable) — The final URL after redirect resolution (present when redirected is true)

### WebsitePagesItem

- `url` (string, optional)
- `category` (string, optional)
- `screenshot_url` (string, optional)

### WebsiteEmailAddressesItem

- `object` (enum, optional)
  - Allowed values: `email_address`
- `email` (string, optional)
- `id` (string, optional)
- `submitted` (boolean, optional)
- `sources` (list of Source, optional)

### WebsiteRating

- `quality_rating` (enum, required)
  - Allowed values: `low`, `moderate`, `high`, `not_available`
- `indicators` (list of WebsiteIndicator, optional)

### WatchlistAgency

- `abbr` (string, required)
- `name` (string, required)
- `org` (string, required)

### WatchlistSource

- `object` (string, required)
- `agency` (string, required)
- `agency_abbr` (string, required)
- `organization` (string, required)
- `title` (string, required)
- `abbr` (string, required)
- `results` (list of WatchlistResult, required)

### BankruptcyCaseUpdatesItem

- `guid` (string, optional)
- `pub_date` (string, optional)
- `description` (string, optional)

### BankruptcyDebtorsItem

- `name` (string, optional)

### CertificationExternalSourcesItem

- `organization` (string, optional)
- `link` (string, optional)

### DocumentSource

- `type` (string, optional) — Source type (e.g., registration)
- `id` (string, optional) — Source record ID
- `metadata` (map from string to any, optional) — Additional source metadata

### LienDebtorsItem

- `name` (string, optional)
- `type` (enum, optional)
  - Allowed values: `ORGANIZATION`, `INDIVIDUAL`, `UNKNOWN`, `Business`
- `party_type` (string, optional)
- `organization_name` (string, optional)
- `entity_type` (string, optional)
- `first_name` (string, optional)
- `last_name` (string, optional)
- `addresses` (list of LienDebtorsItemAddressesItem, optional)

### LienSecuredPartiesItem

- `name` (string, optional)
- `type` (enum, optional)
  - Allowed values: `ORGANIZATION`, `INDIVIDUAL`
- `role` (string, optional)
- `organization_name` (string, optional)
- `addresses` (list of LienSecuredPartiesItemAddressesItem, optional)

### AddressRating

- `risk_rating` (enum, required)
  - Allowed values: `low`, `moderate`, `high`, `not_available`
- `indicators` (list of AddressIndicator, optional)

### AddressDeliverabilityAnalysis

- `message` (string, optional)
- `sub_type` (enum, optional)
  - Allowed values: `Deliverable`, `Undeliverable`, `Unknown`
- `sub_key` (enum, optional)
  - Allowed values: `deliverable`, `undeliverable`, `unknown`

### PersonTitlesItem

- `object` (enum, optional)
  - Allowed values: `person_title`
- `title` (string, optional)

### CriminalHistoryRecord

- `object` (enum, required)
  - Allowed values: `criminal_history/record`
- `id` (string, required)
- `category` (string, required)
- `cases` (list of CriminalHistoryCase, required)
- `state` (string, optional, nullable)
- `person` (CriminalHistoryRecordPerson, optional)

### EmailRating

- `risk_rating` (enum, required)
  - Allowed values: `low`, `moderate`, `high`
- `indicators` (list of EmailIndicator, optional)

### ProfileMetadata

- `name` (string, optional)
- `city` (string, optional)
- `state` (string, optional)
- `full_address` (string, optional)
- `website_urls` (list of string, optional)
- `latitude` (double, optional)
- `longitude` (double, optional)
- `phone_number` (string, optional)
- `categories` (list of string, optional)
- `reviews` (list of ProfileMetadataReviewsItem, optional)
- `recent_posts` (list of map from string to any, optional)
- `recent_reviews` (list of map from string to any, optional)

### RegistrationJurisdictionDetails

The sub-national jurisdiction for international registrations. `null` for US registrations.

- `name` (string, optional, nullable)
- `abbr` (string, optional, nullable)
- `authority` (string, optional, nullable) — The registry authority for the jurisdiction.

### OrderRequester

- `name` (string, optional, nullable)
- `type` (enum, optional, nullable)
  - Allowed values: `account`, `user`, `api_key`

### IndustryClassificationCategoriesItem

- `classification_system` (enum, optional)
  - Allowed values: `NAICS`, `MCC`, `Prohibited`
- `name` (string, optional) — Industry name
- `sector` (string, optional, nullable) — Industry sector in CONSTANT_CASE
- `category` (string, optional) — Industry category in CONSTANT_CASE
- `score` (double, optional) — Classification confidence score (0.0 to 1.0)
- `high_risk` (boolean, optional) — Whether this industry is considered high risk
- `naics_codes` (list of string, optional) — NAICS (2022) classification codes
- `sic_codes` (list of string, optional) — SIC classification codes
- `mcc_codes` (list of string, optional) — MCC classification codes
- `prohibited_labels` (list of string, optional, nullable) — Prohibited classification labels if applicable
- `risk_program_flags` (list of RiskProgramFlag, optional) — Card-network merchant-risk program flags (Mastercard SMRP, Visa VIRP) this category was flagged under. Present on risk orders, and on website orders for accounts with card-network program flagging enabled; omitted otherwise. Empty when nothing was flagged.

### IndustryClassificationWebsite

- `status` (enum, optional)
  - Allowed values: `online`, `offline`, `unknown`
- `parked` (boolean, optional)

### MonitorEventTypesItem

- `type` (string, optional)
- `enabled_at` (datetime, optional, nullable)
- `status` (enum, optional)
  - Allowed values: `active`, `unavailable`, `pending`

### LoanDetails

- `gender` (string, optional, nullable)
- `veteran` (string, optional, nullable)
- `naics_code` (LoanDetailsNaicsCode, optional, nullable)
- `non_profit` (string, optional, nullable)
- `business_type` (string, optional, nullable)
- `jobs_reported` (string, optional, nullable)
- `race_ethnicity` (string, optional, nullable)

### Judgment

- `id` (string, required)
- `litigation_id` (string, required)
- `docket_entry_date` (date, required)
- `text` (string, required)
- `created_at` (datetime, required)
- `updated_at` (datetime, required)
- `amount_cents` (integer, optional, nullable) — The judgment amount in cents. For example, 5000000 represents $50,000.00. Null if no monetary amount is associated with the judgment.

### LitigationPartiesItem

- `id` (string, required)
- `name` (string, required)
- `role` (enum, required)
  - Allowed values: `Plaintiff`, `Defendant`, `Cross-Plaintiff`, `Cross-Defendant`
- `litigation_id` (string, required)
- `created_at` (datetime, optional)
- `updated_at` (datetime, optional)

### PolicyActionResult

- `object` (string, optional)
- `id` (string, optional) — Policy action result ID
- `details` (map from string to any, optional) — Action details
- `executed` (boolean, optional) — Execution status
- `policy_action` (PolicyActionResultPolicyAction, optional)

### PoliticallyExposedPersonScreeningResultsItem

- `object` (enum, optional)
  - Allowed values: `politically_exposed_person_screening_result`
- `id` (string, optional)
- `aliases` (list of string, optional)
- `birth_name` (string, optional, nullable)
- `birth_place` (string, optional, nullable)
- `citizenship_country` (string, optional, nullable)
- `dob` (string, optional, nullable)
- `employers` (list of string, optional)
- `hit_type` (enum, optional)
  - Allowed values: `direct`, `direct_alias`, `association`
- `memberships` (list of map from string to any, optional)
- `name` (string, optional)
- `professional_history` (list of string, optional)
- `score` (double, optional)
- `source_urls` (list of string, optional)
- `stakeholders` (list of map from string to any, optional)

### PoliticallyExposedPersonScreeningSettings

- `people` (string, optional)
- `match_score` (enum, optional)
  - Allowed values: `LOW`, `MEDIUM`, `HIGH`

### AdverseMediaScreeningResultsItem

- `object` (enum, optional)
  - Allowed values: `adverse_media_screening_result`
- `id` (string, optional)
- `risk_scores` (map from string to double, optional)
- `created_at` (datetime, optional)
- `updated_at` (datetime, optional)
- `match_score` (double, optional)
- `items` (list of AdverseMediaScreeningResultsItemItemsItem, optional)

### AdverseMediaScreeningExclusionSettings

- `criteria_match_threshold` (double, optional)
- `max_people_screened` (integer, optional)
- `max_names_screened` (integer, optional)
- `people` (list of map from string to any, optional)

### SignalRequester

- `id` (string, required)
- `type` (string, required)
- `name` (string, required)

### SignalReasonsItem

- `category` (enum, required)
  - Allowed values: `identification`, `verification`, `evaluation`
- `group` (string, required)
- `description` (string, required)
- `code` (enum, required)
  - Allowed values: `I301`, `I302`, `I304`, `I102`, `I103`, `I107`, `I108`, `I109`, `I111`, `I601`, `I603`, `I201`, `I202`, `I203`, `I204`, `V010`, `V011`, `V101`, `V102`, `V103`, `V104`, `V501`, `V502`, `V503`, `V505`, `V748`, `V749`, `V750`, `V751`, `V752`, `V753`, `V801`, `V1101`, `V1201`, `V1302`, `E500`, `E501`, `E502`, `E503`, `E1101`, `E1102`, `E1201`
- `importance` (double, optional)

### SubmittedAttributeOrdersItem

- `product` (string, optional)

### WebsiteDomainRegistrar

- `organization` (string, optional, nullable)
- `name` (string, optional)
- `url` (string, optional, nullable)

### WebsiteIndicator

- `type` (enum, required)
  - Allowed values: `domain_age`, `top_level_domain`, `content_diversity`, `contact_info`, `compliance_info`, `page_count`, `broken_links`, `domain_consistency`, `update_frequency`, `filler_text`, `image_quality`, `last_updated`, `third_party_profile_links`, `us_business_presence`, `spelling_and_grammar`, `https`, `domain_ownership`
- `name` (string, required)
- `rating` (enum, required)
  - Allowed values: `positive`, `negative`, `neutral`
- `value` (string, required)
- `description` (string, required)

### WatchlistResult

- `object` (enum, required)
  - Allowed values: `watchlist_result`
- `id` (string, required)
- `status` (string, required)
- `entity_name` (string, required)
- `entity_aliases` (list of string, required)
- `agency_information_url` (string, required)
- `agency_list_url` (string, required)
- `score` (double, required, nullable)
- `listed_at` (datetime, optional, nullable)
- `addresses` (list of WatchlistResultAddressesItem, optional)
- `url` (string, optional, nullable)
- `list_country` (string, optional)
- `list_url` (string, optional, nullable)
- `list_region` (string, optional)
- `categories` (list of string, optional)

### LienDebtorsItemAddressesItem

- `full_address` (string, optional)
- `address_line1` (string, optional)
- `address_line2` (string, optional, nullable)
- `city` (string, optional)
- `state` (string, optional)
- `postal_code` (string, optional)

### LienSecuredPartiesItemAddressesItem

- `full_address` (string, optional)
- `address_line1` (string, optional)
- `address_line2` (string, optional, nullable)
- `city` (string, optional)
- `state` (string, optional)
- `postal_code` (string, optional)

### AddressIndicator

- `type` (enum, required)
  - Allowed values: `valid_us_address`, `deliverability`, `geographical_location`, `registered_agent`, `private_mailbox`, `location_frequency`, `property_type`, `virtual_address`
- `name` (enum, required)
  - Allowed values: `Valid US address`, `Commercial registered agent`, `Geographical location`, `Private mailbox`, `Virtual address`, `Location frequency`, `Deliverability`, `Property type`
- `rating` (enum, required)
  - Allowed values: `positive`, `negative`, `neutral`
- `value` (string, required)
- `description` (string, required)

### CriminalHistoryCase

- `object` (enum, required)
  - Allowed values: `criminal_history/case`
- `charges` (list of CriminalHistoryCharge, required)
- `arrest_date` (date, optional, nullable)
- `case_number` (string, optional, nullable)
- `case_type` (string, optional, nullable)
- `court_county` (string, optional, nullable)
- `court_name` (string, optional, nullable)
- `file_date` (date, optional, nullable)
- `status` (string, optional, nullable)
- `title` (string, optional, nullable)
- `arresting_agency` (string, optional, nullable)

### CriminalHistoryRecordPerson

- `dob` (date, optional, nullable)

### EmailIndicator

- `type` (enum, required)
  - Allowed values: `email_validity`, `email_deliverability`, `email_domain_reputation`, `email_domain_configuration`, `email_account_activity`, `email_data_breach_exposure`, `email_address_type`
- `name` (string, required)
- `rating` (enum, required)
  - Allowed values: `positive`, `negative`, `neutral`
- `value` (string, required)
- `description` (string, required)

### ProfileMetadataReviewsItem

- `rating` (double, optional)
- `posted_at` (datetime, optional)

### RiskProgramFlag

A card-network merchant-risk program the industry classification was flagged under. Present on risk orders, and on website orders for accounts with card-network program flagging enabled; enrichment only — never contributes to the risk score or level.

- `program` (enum, required) — The card-network merchant-risk program.
  - Allowed values: `SMRP`, `VIRP`
- `program_category` (string, required) — The network listing category (e.g. `crypto`, `pharmacy`, `gambling`).
- `tier` (RiskProgramFlagTier, optional) — VIRP tier severity. Present only for VIRP flags; absent for SMRP (which is untiered).

### LoanDetailsNaicsCode

- `code` (integer, optional)
- `title` (string, optional)
- `description` (string, optional)

### PolicyActionResultPolicyAction

- `id` (string, optional) — Policy action ID
- `action_type` (string, optional) — Type of action
- `options` (map from string to any, optional) — Action options
- `policy_version_id` (string, optional) — Policy version ID

### AdverseMediaScreeningResultsItemItemsItem

- `object` (enum, optional)
  - Allowed values: `adverse_media_item`
- `source_name` (string, optional)
- `title` (string, optional)
- `url` (string, optional)
- `flags` (AdverseMediaScreeningResultsItemItemsItemFlags, optional)
- `created_at` (datetime, optional)
- `updated_at` (datetime, optional)

### WatchlistResultAddressesItem

- `full_address` (string, optional)

### CriminalHistoryCharge

- `object` (enum, required)
  - Allowed values: `criminal_history/charge`
- `category` (string, optional, nullable)
- `charge_type` (string, optional, nullable)
- `city` (string, optional, nullable)
- `county` (string, optional, nullable)
- `description` (string, optional, nullable)
- `dispositions` (list of CriminalHistoryChargeDispositionsItem, optional)
- `legal_code` (string, optional, nullable)
- `offense_date` (date, optional, nullable)
- `sentences` (list of CriminalHistoryChargeSentencesItem, optional, nullable)
- `state` (string, optional, nullable)
- `subcategory` (string, optional, nullable)
- `subsubcategory` (string, optional, nullable)

### RiskProgramFlagTier

VIRP tier severity. Present only for VIRP flags; absent for SMRP (which is untiered).

- `level` (integer, required) — VIRP tier severity level.
- `harm_type` (enum, required)
  - Allowed values: `health_safety`, `financial`, `regulatory_deceptive`

### AdverseMediaScreeningResultsItemItemsItemFlags

- `risks` (list of AdverseMediaScreeningResultsItemItemsItemFlagsRisksItem, optional)
- `sentiments` (list of AdverseMediaScreeningResultsItemItemsItemFlagsSentimentsItem, optional)

### CriminalHistoryChargeDispositionsItem

- `disposition` (string, optional, nullable)
- `disposition_date` (date, optional, nullable)
- `disposition_type` (string, optional, nullable)

### CriminalHistoryChargeSentencesItem

- `details` (string, optional)

### AdverseMediaScreeningResultsItemItemsItemFlagsRisksItem

- `name` (string, optional)
- `confidence_level` (enum, optional)
  - Allowed values: `low`, `moderate`, `high`

### AdverseMediaScreeningResultsItemItemsItemFlagsSentimentsItem

- `name` (enum, optional)
  - Allowed values: `positive`, `negative`, `neutral`
- `confidence_level` (enum, optional)
  - Allowed values: `low`, `moderate`, `high`

## Examples

**Request**

```json
{}
```

**Response**

```json
{
  "object": "business",
  "id": "id",
  "name": "name",
  "status": "open",
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z",
  "external_id": "external_id",
  "unique_external_id": "unique_external_id",
  "tags": [
    "tags"
  ],
  "requester": {
    "id": "id",
    "type": "account",
    "name": "name",
    "requested_at": "2024-01-15T09:30:00Z"
  },
  "assignee_id": "assignee_id",
  "supported_document_types": [
    "Articles of Incorporation"
  ],
  "review": {
    "object": "review",
    "id": "id",
    "created_at": "2024-01-15T09:30:00Z",
    "updated_at": "2024-01-15T09:30:00Z",
    "tasks": [
      {
        "category": "bankruptcies",
        "key": "location_frequency",
        "label": "Politically Exposed Persons",
        "message": "message",
        "name": "name",
        "status": "success",
        "sub_label": "sub_label",
        "sources": [
          {
            "id": "id",
            "type": "type",
            "metadata": {
              "key": "value"
            }
          }
        ]
      }
    ],
    "completed_at": "2024-01-15T09:30:00Z",
    "analyst_read_markdown": "analyst_read_markdown",
    "analyst_read_generated_at": "2024-01-15T09:30:00Z",
    "assignee": {
      "object": "user",
      "id": "id",
      "name": "name",
      "email": "email",
      "roles": [
        "roles"
      ],
      "created_at": "2024-01-15T09:30:00Z",
      "image_url": "image_url",
      "directory_managed": true,
      "last_login_at": "2024-01-15T09:30:00Z",
      "settings": {
        "key": "value"
      }
    }
  },
  "tin": {
    "business_id": "business_id",
    "tin": "tin",
    "name": "name",
    "mismatch": true,
    "unknown": true,
    "verified": true,
    "error": "error",
    "updated_at": "2024-01-15T09:30:00Z",
    "issued": true,
    "verified_by": "verified_by"
  },
  "business_batch_id": "business_batch_id",
  "formation": {
    "created_at": "2024-01-15T09:30:00Z",
    "updated_at": "2024-01-15T09:30:00Z",
    "entity_type": "entity_type",
    "formation_date": "2023-01-15",
    "formation_state": "formation_state",
    "sources": [
      {
        "id": "id",
        "type": "type",
        "metadata": {
          "key": "value"
        }
      }
    ]
  },
  "website": {
    "object": "website",
    "id": "id",
    "url": "url",
    "created_at": "2024-01-15T09:30:00Z",
    "updated_at": "2024-01-15T09:30:00Z",
    "status": "online",
    "parked": true,
    "submitted": true,
    "business_id": "business_id",
    "business_name_match": true,
    "phone_numbers": [
      {}
    ],
    "addresses": [
      {}
    ],
    "http_status_code": 1,
    "title": "title",
    "description": "description",
    "domain": {
      "domain": "domain",
      "domain_id": "domain_id",
      "creation_date": "2024-01-15T09:30:00Z",
      "expiration_date": "2024-01-15T09:30:00Z",
      "redirected": true,
      "url_shortener": true,
      "resolved_url": "resolved_url"
    },
    "pages": [
      {}
    ],
    "error": "error",
    "category": "category",
    "platform": "platform",
    "posts_summary": "posts_summary",
    "reviews_summary": "reviews_summary",
    "names": [
      {
        "object": "name",
        "id": "id",
        "name": "name",
        "submitted": true,
        "business_id": "business_id",
        "sources": [
          {
            "id": "id",
            "type": "type",
            "metadata": {
              "key": "value"
            }
          }
        ]
      }
    ],
    "people": [
      {
        "key": "value"
      }
    ],
    "email_addresses": [
      {}
    ],
    "rating": {
      "quality_rating": "low",
      "indicators": [
        {
          "type": "domain_age",
          "name": "name",
          "rating": "positive",
          "value": "value",
          "description": "description"
        }
      ]
    }
  },
  "watchlist": {
    "object": "watchlist",
    "id": "id",
    "hit_count": 1,
    "agencies": [
      {
        "abbr": "abbr",
        "name": "name",
        "org": "org"
      }
    ],
    "lists": [
      {
        "object": "watchlist_source",
        "agency": "agency",
        "agency_abbr": "agency_abbr",
        "organization": "organization",
        "title": "title",
        "abbr": "abbr",
        "results": [
          {
            "object": "watchlist_result",
            "id": "id",
            "status": "status",
            "entity_name": "entity_name",
            "entity_aliases": [
              "entity_aliases"
            ],
            "agency_information_url": "agency_information_url",
            "agency_list_url": "agency_list_url",
            "score": null
          }
        ]
      }
    ],
    "people": [
      {
        "key": "value"
      }
    ]
  },
  "risk": {
    "object": "risk",
    "status": "completed",
    "level": "low",
    "score": 1,
    "latest_assessment_id": "latest_assessment_id",
    "reason": "reason"
  },
  "bankruptcies": [
    {
      "object": "bankruptcy",
      "id": "id",
      "business_id": "business_id",
      "case_number": "case_number",
      "case_updates": [
        {}
      ],
      "chapter": 1.1,
      "court": "court",
      "filing_date": "2023-01-15",
      "debtors": [
        {}
      ]
    }
  ],
  "certifications": [
    {
      "object": "certification",
      "name": "name",
      "key": "key",
      "certification_type": "federal",
      "external_sources": [
        {}
      ],
      "id": "id",
      "business_id": "business_id",
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-01-15T09:30:00Z",
      "entrance_date": "2024-01-15T09:30:00Z",
      "exit_date": "2024-01-15T09:30:00Z",
      "certification_id": "certification_id"
    }
  ],
  "documents": [
    {
      "object": "document",
      "id": "id",
      "document_type": "document_type",
      "filename": "filename",
      "content_type": "application/pdf",
      "size": 1,
      "download_url": "download_url",
      "created_at": "2024-01-15T09:30:00Z",
      "filing_date": "2024-01-15T09:30:00Z",
      "metadata": {
        "key": "value"
      }
    }
  ],
  "liens": [
    {
      "object": "lien",
      "type": "ucc",
      "id": "id",
      "business_id": "business_id",
      "debtors": [
        {}
      ],
      "secured_parties": [
        {}
      ],
      "file_number": "file_number",
      "state": "AL",
      "status": "created",
      "filing_date": "2023-01-15",
      "status_category": "active",
      "owner_id": "owner_id",
      "owner_type": "owner_type",
      "documents": [
        {
          "object": "document",
          "id": "id",
          "document_type": "document_type",
          "filename": "filename",
          "content_type": "application/pdf",
          "size": 1,
          "download_url": "download_url",
          "created_at": "2024-01-15T09:30:00Z"
        }
      ],
      "updated_date": "2023-01-15",
      "lapse_date": "2023-01-15",
      "collateral": "collateral",
      "collateral_type": "Blanket",
      "negative_pledge": true,
      "confirmation_number": "confirmation_number",
      "loan_principal_amount_cents": 1,
      "source": "source",
      "packet_number": "packet_number",
      "lien_termination": {
        "key": "value"
      },
      "liability_cents": 1,
      "alternative_designation": "buyer_seller",
      "filed_by_account": true
    }
  ],
  "names": [
    {
      "object": "name",
      "id": "id",
      "name": "name",
      "submitted": true,
      "business_id": "business_id",
      "sources": [
        {
          "id": "id",
          "type": "type",
          "metadata": {
            "key": "value"
          }
        }
      ],
      "type": "legal"
    }
  ],
  "addresses": [
    {
      "object": "address",
      "id": "id",
      "full_address": "full_address",
      "submitted": true,
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-01-15T09:30:00Z",
      "business_id": "business_id",
      "sources": [
        {
          "id": "id",
          "type": "type",
          "metadata": {
            "key": "value"
          }
        }
      ],
      "rating": {
        "risk_rating": "low"
      },
      "address_line1": "address_line1",
      "address_line2": "address_line2",
      "city": "city",
      "state": "AL",
      "postal_code": "postal_code",
      "latitude": 1.1,
      "longitude": 1.1,
      "property_type": "commercial",
      "deliverable": true,
      "street_view_available": true,
      "labels": [
        "labels"
      ],
      "references": [
        "references"
      ],
      "registered_agent_name": "registered_agent_name",
      "cmra": true,
      "location_count": 1,
      "is_registered_agent": true
    }
  ],
  "people": [
    {
      "object": "person",
      "id": "id",
      "name": "name",
      "submitted": true,
      "business_id": "business_id",
      "titles": [
        {}
      ],
      "people_bankruptcies": [
        {
          "key": "value"
        }
      ],
      "litigations": [
        {
          "object": "litigation",
          "id": "id",
          "case_name": "case_name",
          "case_number": "case_number",
          "case_status": "OPEN",
          "case_type": "case_type",
          "filing_date": "2025-06-18",
          "party_type": "party_type"
        }
      ],
      "liens": [
        {
          "object": "lien",
          "type": "ucc",
          "id": "id",
          "business_id": "business_id",
          "debtors": [
            {}
          ],
          "secured_parties": [
            {}
          ],
          "file_number": null,
          "state": "AL",
          "status": "created",
          "filing_date": null,
          "status_category": "active",
          "owner_id": "owner_id",
          "owner_type": "owner_type",
          "documents": [
            {
              "object": "document",
              "id": "id",
              "document_type": "document_type",
              "filename": "filename",
              "content_type": "application/pdf",
              "size": 1,
              "download_url": "download_url",
              "created_at": "2024-01-15T09:30:00Z"
            }
          ]
        }
      ],
      "criminal_records": [
        {
          "object": "criminal_history/record",
          "id": "id",
          "category": "category",
          "cases": [
            {
              "object": "criminal_history/case",
              "charges": [
                {
                  "object": "criminal_history/charge"
                }
              ]
            }
          ]
        }
      ],
      "sources": [
        {
          "id": "id",
          "type": "type",
          "metadata": {
            "key": "value"
          }
        }
      ]
    }
  ],
  "phone_numbers": [
    {
      "object": "phone_number",
      "id": "id",
      "number": "number",
      "contact_type": "contact_type",
      "recommended": true
    }
  ],
  "email_addresses": [
    {
      "object": "email_address",
      "id": "id",
      "email": "email",
      "submitted": true,
      "sources": [
        {
          "id": "id",
          "type": "type",
          "metadata": {
            "key": "value"
          }
        }
      ],
      "domain": "domain",
      "valid": true,
      "deliverability": "deliverability",
      "disposable": true,
      "address_type": "disposable",
      "business_id": "business_id",
      "domain_age": "2024-01-15T09:30:00Z",
      "first_seen": "2024-01-15T09:30:00Z",
      "rating": {
        "risk_rating": "low"
      }
    }
  ],
  "profiles": [
    {
      "object": "profile",
      "id": "id",
      "type": "facebook",
      "url": "url",
      "external_id": "external_id",
      "rating": 1.1,
      "rating_count": 1
    }
  ],
  "registrations": [
    {
      "object": "registration",
      "id": "id",
      "business_id": "business_id",
      "name": "name",
      "status": "status",
      "jurisdiction": "jurisdiction",
      "entity_type": "entity_type",
      "file_number": "file_number",
      "state": "AL",
      "sub_status": "sub_status",
      "status_details": "status_details",
      "country_code": "country_code",
      "addresses": [
        "addresses"
      ],
      "officers": [
        {
          "key": "value"
        }
      ],
      "registered_agent": {
        "key": "value"
      },
      "registration_date": "2023-01-15",
      "source": "source",
      "submitted": true
    }
  ],
  "orders": [
    {
      "object": "order",
      "id": "id",
      "status": "created",
      "business_id": "business_id",
      "product": "identity",
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-01-15T09:30:00Z",
      "subproducts": [
        "Articles of Incorporation"
      ],
      "completed_at": "2024-01-15T09:30:00Z",
      "monitoring": true
    }
  ],
  "industry_classification": {
    "object": "industry_classification",
    "id": "id",
    "status": "pending",
    "categories": [
      {}
    ],
    "created_at": "2024-01-15T09:30:00Z",
    "completed_at": "2024-01-15T09:30:00Z",
    "website": {
      "status": "online",
      "parked": true
    }
  },
  "monitor": {
    "object": "monitor",
    "id": "id",
    "created_at": "2024-01-15T09:30:00Z",
    "event_types": [
      {}
    ]
  },
  "tax_exempt_organization": {
    "object": "tax_exempt_organization",
    "id": "id",
    "ein": "ein",
    "name": "name",
    "section": "section",
    "ruling_date": "2023-01-15",
    "tax_period": "2023-01-15",
    "revoked_at": "2024-01-15T09:30:00Z"
  },
  "fmcsa_registrations": [
    {
      "object": "fmcsa_registration",
      "id": "id",
      "dot_number": "dot_number",
      "legal_name": "legal_name",
      "source": "source",
      "addresses": [
        "addresses"
      ],
      "dba_name": "dba_name"
    }
  ],
  "loans": [
    {
      "object": "loan",
      "id": "id",
      "issued_date": "2023-01-15",
      "amount": 1.1,
      "lender": "lender"
    }
  ],
  "litigations": [
    {
      "object": "litigation",
      "id": "id",
      "case_name": "case_name",
      "case_number": "case_number",
      "case_status": "OPEN",
      "case_type": "case_type",
      "filing_date": "2025-06-18",
      "party_type": "party_type",
      "judgments": [
        {
          "id": "id",
          "litigation_id": "litigation_id",
          "docket_entry_date": "2023-01-15",
          "text": "text",
          "created_at": "2024-01-15T09:30:00Z",
          "updated_at": "2024-01-15T09:30:00Z"
        }
      ],
      "jurisdiction": "jurisdiction",
      "jurisdiction_state": "jurisdiction_state",
      "parties": [
        {
          "id": "id",
          "name": "name",
          "role": "Plaintiff",
          "litigation_id": "litigation_id"
        }
      ]
    }
  ],
  "policy_results": [
    {
      "object": "policy_result",
      "id": "id",
      "result": "result",
      "created_at": "created_at",
      "matched": "matched",
      "executed": true,
      "name": "name",
      "details": {
        "key": "value"
      },
      "owner_id": "owner_id",
      "owner_type": "owner_type",
      "business_id": "business_id",
      "type_of": "type_of",
      "policy_action_results": [
        {
          "object": "policy_action_result"
        }
      ]
    }
  ],
  "politically_exposed_person_screening": {
    "object": "politically_exposed_person_screening",
    "id": "id",
    "created_at": "2024-01-15T09:30:00Z",
    "updated_at": "2024-01-15T09:30:00Z",
    "results": [
      {}
    ],
    "settings": {
      "people": "people",
      "match_score": "LOW"
    }
  },
  "adverse_media_screening": {
    "object": "adverse_media_screening",
    "id": "id",
    "created_at": "2024-01-15T09:30:00Z",
    "updated_at": "2024-01-15T09:30:00Z",
    "results": [
      {}
    ],
    "exclusion_settings": {
      "criteria_match_threshold": 1.1,
      "max_people_screened": 1,
      "max_names_screened": 1,
      "people": [
        {
          "key": "value"
        }
      ]
    }
  },
  "signal": {
    "object": "signal",
    "id": "id",
    "name": "name",
    "created_at": "2024-01-15T09:30:00Z",
    "tin": "tin",
    "external_id": "external_id",
    "model_slug": "model_slug",
    "score": 1.1,
    "business_id": "business_id",
    "batch_id": "batch_id",
    "requester": {
      "id": "id",
      "type": "type",
      "name": "name"
    },
    "reasons": [
      {
        "category": "identification",
        "group": "group",
        "description": "description",
        "code": "I301"
      }
    ],
    "addresses": [
      "addresses"
    ],
    "people": [
      "people"
    ]
  },
  "submitted": {
    "object": "submitted_attributes",
    "name": "name",
    "name_derived": true,
    "entity_type": "entity_type",
    "addresses": [
      {
        "key": "value"
      }
    ],
    "orders": [
      {}
    ],
    "people": [
      {
        "key": "value"
      }
    ],
    "phone_numbers": [
      {
        "key": "value"
      }
    ],
    "email_addresses": [
      {
        "key": "value"
      }
    ],
    "tags": [
      "tags"
    ],
    "external_id": "external_id",
    "unique_external_id": "unique_external_id",
    "tin": {
      "key": "value"
    },
    "website": {
      "key": "value"
    },
    "assignee_id": "assignee_id",
    "formation": {
      "key": "value"
    },
    "names": [
      {
        "key": "value"
      }
    ],
    "profiles": [
      {
        "key": "value"
      }
    ]
  },
  "subscription": {
    "object": "subscription",
    "id": "id"
  },
  "subscription_availability": {
    "bankruptcy": "subscribable",
    "certification": "subscribable",
    "registration": "subscribable",
    "tin": "subscribable",
    "watchlist_result": "subscribable",
    "lien": "subscribable"
  }
}
```

**SDK Code**

```python
import requests

url = "https://api.middesk.com/v1/businesses/id"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api.middesk.com/v1/businesses/id';
const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.middesk.com/v1/businesses/id"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.middesk.com/v1/businesses/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.patch("https://api.middesk.com/v1/businesses/id")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('PATCH', 'https://api.middesk.com/v1/businesses/id', [
  'body' => '{}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.middesk.com/v1/businesses/id");
var request = new RestRequest(Method.PATCH);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = [] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses/id")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "PATCH"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```