---
title: "Update a business"
method: PATCH
path: "/v1/businesses/{id}"
tags: ["businesses"]
---

# Update a business

`PATCH /v1/businesses/{id}`

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Request body

- object
  - `name` string
  - `status` 'in_review' | 'approved' | 'rejected' — Status to set for the business (only final statuses allowed)
  - `tin` TypeBusinessesBusinessUpdateParamTin
    - `tin` string
  - `addresses` TypeBusinessesBusinessUpdateParamAddressesItem[]
    - union
      - TypeSubmittedAddressFull
        - `full_address` string, required — Complete address as a single string
        - `reference` string — Optional, customer-supplied key to identify an address
      - TypeSubmittedAddressComponent
        - `address_line_1` string, required
        - `address_line_2` string
        - `city` string, required
        - `state` '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', required
        - `postal_code` string
        - `country` string
        - `reference` string — Optional, customer-supplied key to identify an address
  - `website` TypeBusinessesBusinessUpdateParamWebsite — 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, uri — The website URL for the business
  - `phone_numbers` TypeBusinessesBusinessUpdateParamPhoneNumbersItem[] — Phone numbers to add to the business. Numbers that already exist on the business are ignored.
    - `phone_number` string
  - `people` TypeSubmittedPerson[]
    - `name` string, required — Full name of the person
    - `first_name` string — The person's first (given) name.
    - `middle_name` string — The person's middle name.
    - `last_name` string — The person's last (family) name.
    - `name_suffix` string — 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 — Job title or role
    - `email` string, email
    - `phone` string
  - `external_id` string
  - `unique_external_id` string
  - `tags` string[]

## Response `200`

business updated

- TypeBusiness
  - `object` string, required
  - `id` string, uuid, required
  - `external_id` string, nullable
  - `unique_external_id` string, nullable
  - `name` string, required
  - `status` 'open' | 'pending' | 'in_audit' | 'in_review' | 'approved' | 'rejected', required — Current status of the business verification
  - `tags` string[]
  - `requester` TypeRequester
    - `id` string, uuid, required
    - `type` 'account' | 'user', required
    - `name` string, required
    - `requested_at` string, date-time, required
  - `assignee_id` string, uuid, nullable
  - `supported_document_types` TypeBusinessSupportedDocumentTypesItem[]
  - `review` TypeReview
    - `object` 'review', required
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `completed_at` string, date-time, nullable
    - `tasks` TypeReviewTask[], required
      - `category` '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', required
      - `key` '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', required
      - `label` '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', required
      - `message` string, required
      - `name` string, required
      - `status` 'success' | 'failure' | 'warning' | 'neutral', required
      - `sub_label` string, required
      - `sources` TypeSource[], required
        - `id` string, uuid, 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` object, required
    - `assignee` TypeUser
      - `object` string, required
      - `id` string, uuid, required
      - `name` string, required
      - `email` string, email, required
      - `roles` string[], required
      - `image_url` string, uri
      - `directory_managed` boolean
      - `last_login_at` string, date-time, nullable
      - `settings` object
      - `created_at` string, date-time, required
  - `tin` TypeTin
    - `name` string, nullable
    - `mismatch` boolean
    - `unknown` boolean
    - `verified` boolean, nullable
    - `error` string, nullable
    - `updated_at` string, date-time
    - `issued` boolean, nullable
    - `verified_by` string, nullable
    - `business_id` string, uuid, required
    - `tin` string, required
  - `business_batch_id` string, uuid, nullable
  - `formation` TypeFormation
    - `entity_type` string
    - `formation_date` string, date
    - `formation_state` string
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `sources` TypeSource[]
      - `id` string, uuid, 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` object, required
  - `website` TypeWebsite
    - `object` 'website', required
    - `id` string, uuid, required
    - `url` string, uri, nullable, required — The URL that was passed or found for the Business
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `status` 'online' | 'offline' | 'unknown', required
    - `http_status_code` integer, nullable — HTTP response status code
    - `title` string, nullable — Website page title
    - `description` string, nullable — Website meta description
    - `domain` TypeWebsiteDomain
      - `domain` string
      - `domain_id` string, nullable
      - `creation_date` string, date-time
      - `expiration_date` string, date-time
      - `registrar` TypeWebsiteDomainRegistrar
        - `organization` string, nullable
        - `name` string
        - `url` string, uri, nullable
      - `redirected` boolean, nullable — Whether the domain redirects to a different URL
      - `url_shortener` boolean, nullable — Whether the domain uses a URL shortener service
      - `resolved_url` string, uri, nullable — The final URL after redirect resolution (present when redirected is true)
    - `pages` TypeWebsitePagesItem[] — Website pages with screenshots
      - `url` string, uri
      - `category` string
      - `screenshot_url` string, uri
    - `parked` boolean, nullable, required — Whether the domain is parked
    - `submitted` boolean, required — Whether the website was submitted by user
    - `error` string, nullable — Error message if website analysis failed
    - `category` string, nullable — Website category classification
    - `platform` string, nullable — Website platform (e.g., instagram.com, facebook.com)
    - `posts_summary` string, nullable — Summary of posts found on the website or linked social media profiles
    - `reviews_summary` string, nullable — Summary of reviews found on the website or linked third-party profiles
    - `business_id` string, uuid, required
    - `business_name_match` boolean, required — Whether website content matches business name
    - `names` TypeName[] — Names found on website
      - `object` string, required
      - `id` string, uuid, required
      - `name` string, required
      - `submitted` boolean, required
      - `type` 'legal' | 'dba'
      - `business_id` string, uuid, required
      - `sources` TypeSource[], required
        - `id` string, uuid, 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` object, required
    - `phone_numbers` TypeWebsitePhoneNumber[], required — Phone numbers found on website
      - `object` 'phone_number'
      - `id` string, uuid
      - `number` string
      - `contact_type` string, nullable
      - `recommended` boolean, nullable
      - `submitted` boolean
      - `sources` TypeSource[], nullable
        - `id` string, uuid, 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` object, required
    - `people` object[], nullable — People found on website
    - `addresses` TypeWebsiteAddressesItem[], required — Addresses found on website
      - `object` string
      - `id` string, uuid
      - `address_line1` string, nullable
      - `address_line2` string, nullable
      - `city` string, nullable
      - `state` string, nullable
      - `postal_code` string, nullable
      - `full_address` string
      - `submitted` boolean
      - `sources` TypeSource[]
        - `id` string, uuid, 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` object, required
    - `email_addresses` TypeWebsiteEmailAddressesItem[], nullable — Email addresses found on website
      - `object` 'email_address'
      - `email` string
      - `id` string, uuid
      - `submitted` boolean
      - `sources` TypeSource[]
        - `id` string, uuid, 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` object, required
    - `rating` TypeWebsiteRating
      - `indicators` TypeWebsiteIndicator[]
        - `type` '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', required
        - `name` string, required
        - `rating` 'positive' | 'negative' | 'neutral', required
        - `value` string, required
        - `description` string, required
      - `quality_rating` 'low' | 'moderate' | 'high' | 'not_available', required
  - `watchlist` TypeWatchlist
    - `object` string, required
    - `id` string, uuid, required
    - `hit_count` integer, required
    - `agencies` TypeWatchlistAgency[], required
      - `abbr` string, required
      - `name` string, required
      - `org` string, required
    - `lists` TypeWatchlistSource[], required
      - `object` string, required
      - `agency` string, required
      - `agency_abbr` string, required
      - `organization` string, required
      - `title` string, required
      - `abbr` string, required
      - `results` TypeWatchlistResult[], required
        - `object` 'watchlist_result', required
        - `id` string, uuid, required
        - `status` string, required
        - `entity_name` string, required
        - `entity_aliases` string[], required
        - `listed_at` string, date-time, nullable
        - `agency_information_url` string, required
        - `agency_list_url` string, required
        - `score` number, double, nullable, required
        - `addresses` TypeWatchlistResultAddressesItem[]
          - `full_address` string
        - `url` string, uri, nullable
        - `list_country` string
        - `list_url` string, uri, nullable
        - `list_region` string
        - `categories` string[]
    - `people` object[], required
  - `risk` TypeBusinessRisk — 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` 'risk', required — The resource type, always `risk`.
    - `status` 'completed' | 'unavailable', required — Whether the Risk order produced a verdict or stopped unavailable.
    - `level` 'low' | 'moderate' | 'high' | 'not_available' — 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`.
    - `score` integer — 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, uuid — Id of the Risk Assessment resource, present when `status` is `completed`.
    - `reason` string — Why no verdict was produced, present when `status` is `unavailable`.
  - `bankruptcies` TypeBankruptcy[]
    - `object` 'bankruptcy', required
    - `id` string, uuid, required
    - `business_id` string, uuid, required
    - `case_number` string, required
    - `case_updates` TypeBankruptcyCaseUpdatesItem[], required
      - `guid` string
      - `pub_date` string
      - `description` string
    - `chapter` number, double, required
    - `court` string, required
    - `filing_date` string, date, nullable, required
    - `debtors` TypeBankruptcyDebtorsItem[], required
      - `name` string
  - `certifications` TypeCertification[]
    - `object` 'certification', required
    - `id` string, uuid
    - `business_id` string, uuid
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `entrance_date` string, date-time, nullable
    - `exit_date` string, date-time, nullable
    - `certification_id` string, nullable
    - `name` string, required
    - `key` string, required
    - `certification_type` 'federal' | 'self_certified', required
    - `external_sources` TypeCertificationExternalSourcesItem[], required
      - `organization` string
      - `link` string
  - `documents` TypeDocument[]
    - `object` 'document', required
    - `id` string, uuid, 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, uri, required — URL to download the document
    - `created_at` string, date-time, required
    - `source` TypeDocumentSource
      - `type` string — Source type (e.g., registration)
      - `id` string, uuid — Source record ID
      - `metadata` object — Additional source metadata
    - `filing_date` string, date-time, nullable
    - `metadata` object — Additional document metadata
  - `liens` TypeLien[]
    - `object` 'lien', required
    - `type` 'ucc' | 'state' | 'federal' | 'attachment' | 'judgment', required — Type of lien
    - `id` string, uuid, required
    - `business_id` string, uuid, required
    - `debtors` TypeLienDebtorsItem[], required
      - `name` string
      - `type` 'ORGANIZATION' | 'INDIVIDUAL' | 'UNKNOWN' | 'Business'
      - `party_type` string
      - `organization_name` string
      - `entity_type` string
      - `first_name` string
      - `last_name` string
      - `addresses` TypeLienDebtorsItemAddressesItem[]
        - `full_address` string
        - `address_line1` string
        - `address_line2` string, nullable
        - `city` string
        - `state` string
        - `postal_code` string
    - `secured_parties` TypeLienSecuredPartiesItem[], required
      - `name` string
      - `type` 'ORGANIZATION' | 'INDIVIDUAL'
      - `role` string
      - `organization_name` string
      - `addresses` TypeLienSecuredPartiesItemAddressesItem[]
        - `full_address` string
        - `address_line1` string
        - `address_line2` string, nullable
        - `city` string
        - `state` string
        - `postal_code` string
    - `file_number` string, nullable, required — Filing number for the lien
    - `state` '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', required — State where the lien was filed
    - `status` 'created' | 'pending' | 'open' | 'closing' | 'closed' | 'unknown' | 'filed', required — Current status of the lien
    - `filing_date` string, date, nullable, required — Date the lien was filed
    - `updated_date` string, date, nullable — Date the lien was last updated
    - `lapse_date` string, date, nullable — Date the lien lapses/expires
    - `collateral` string, nullable — Description of collateral securing the lien
    - `collateral_type` 'Blanket' | 'Collateral' | 'Unknown' | 'All Assets and Receivables' | 'All Receivables' | 'All Assets' | 'Named Assets' | 'Unavailable'
    - `negative_pledge` boolean — Whether this is a negative pledge
    - `confirmation_number` string, nullable
    - `loan_principal_amount_cents` integer, nullable — Loan principal amount in cents
    - `source` string, uri, nullable — Source URL for the lien data
    - `packet_number` string, nullable
    - `lien_termination` object, nullable — Lien termination details if terminated
    - `liability_cents` integer, nullable — Liability amount in cents
    - `alternative_designation` 'buyer_seller' | 'bailee_bailor' | 'consignee_consignor' | 'lessee_lessor' | 'licensee_licensor'
    - `status_category` 'active' | 'open' | 'closed' | 'terminated' | 'processing' | 'unknown', required — Categorized status of the lien
    - `owner_id` string, uuid, required — Polymorphic owner ID (typically business_id)
    - `owner_type` string, required — Polymorphic owner type (typically Business)
    - `filed_by_account` boolean, nullable — Whether the lien was filed by the account
    - `documents` TypeDocument[], required — Associated lien documents
      - `object` 'document', required
      - `id` string, uuid, 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, uri, required — URL to download the document
      - `created_at` string, date-time, required
      - `source` TypeDocumentSource
        - `type` string — Source type (e.g., registration)
        - `id` string, uuid — Source record ID
        - `metadata` object — Additional source metadata
      - `filing_date` string, date-time, nullable
      - `metadata` object — Additional document metadata
  - `names` TypeName[]
    - `object` string, required
    - `id` string, uuid, required
    - `name` string, required
    - `submitted` boolean, required
    - `type` 'legal' | 'dba'
    - `business_id` string, uuid, required
    - `sources` TypeSource[], required
      - `id` string, uuid, 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` object, required
  - `addresses` TypeAddress[]
    - `object` string, required
    - `id` string, uuid, required
    - `address_line1` string, nullable
    - `address_line2` string, nullable
    - `city` string, nullable
    - `state` '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, nullable
    - `full_address` string, required
    - `submitted` boolean, required
    - `latitude` number, double, nullable
    - `longitude` number, double, nullable
    - `property_type` 'commercial' | 'residential'
    - `deliverable` boolean
    - `deliverability_analysis` TypeAddressDeliverabilityAnalysis
      - `message` string
      - `sub_type` 'Deliverable' | 'Undeliverable' | 'Unknown'
      - `sub_key` 'deliverable' | 'undeliverable' | 'unknown'
    - `street_view_available` boolean, nullable
    - `labels` string[]
    - `references` string[] — References submitted by the customer for this address. Only present when the customer submitted a reference; collapsed duplicate addresses include every submitted key.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `registered_agent_name` string, nullable
    - `cmra` boolean
    - `business_id` string, uuid, required
    - `location_count` integer, nullable
    - `is_registered_agent` boolean, nullable
    - `sources` TypeSource[], required
      - `id` string, uuid, 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` object, required
    - `rating` TypeAddressRating, required
      - `indicators` TypeAddressIndicator[]
        - `type` 'valid_us_address' | 'deliverability' | 'geographical_location' | 'registered_agent' | 'private_mailbox' | 'location_frequency' | 'property_type' | 'virtual_address', required
        - `name` 'Valid US address' | 'Commercial registered agent' | 'Geographical location' | 'Private mailbox' | 'Virtual address' | 'Location frequency' | 'Deliverability' | 'Property type', required
        - `rating` 'positive' | 'negative' | 'neutral', required
        - `value` string, required
        - `description` string, required
      - `risk_rating` 'low' | 'moderate' | 'high' | 'not_available', required
  - `people` TypePerson[]
    - `object` 'person'
    - `id` string, uuid
    - `name` string
    - `submitted` boolean
    - `business_id` string, uuid
    - `titles` TypePersonTitlesItem[]
      - `object` 'person_title'
      - `title` string
    - `people_bankruptcies` object[]
    - `litigations` TypeLitigation[]
      - `object` string, required
      - `id` string, uuid, required
      - `case_name` string, required
      - `case_number` string, required
      - `case_status` 'OPEN' | 'CLOSED' | 'UNKNOWN', required
      - `case_type` string, required
      - `filing_date` string, date, required
      - `judgments` TypeJudgment[]
        - `id` string, uuid, required
        - `litigation_id` string, uuid, required
        - `docket_entry_date` string, date, required
        - `text` string, required
        - `amount_cents` integer, nullable — The judgment amount in cents. For example, 5000000 represents $50,000.00. Null if no monetary amount is associated with the judgment.
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
      - `jurisdiction` string
      - `jurisdiction_state` string, nullable
      - `party_type` string, required
      - `parties` TypeLitigationPartiesItem[]
        - `id` string, uuid, required
        - `name` string, required
        - `role` 'Plaintiff' | 'Defendant' | 'Cross-Plaintiff' | 'Cross-Defendant', required
        - `litigation_id` string, uuid, required
        - `created_at` string, date-time
        - `updated_at` string, date-time
    - `liens` TypeLien[]
      - `object` 'lien', required
      - `type` 'ucc' | 'state' | 'federal' | 'attachment' | 'judgment', required — Type of lien
      - `id` string, uuid, required
      - `business_id` string, uuid, required
      - `debtors` TypeLienDebtorsItem[], required
        - `name` string
        - `type` 'ORGANIZATION' | 'INDIVIDUAL' | 'UNKNOWN' | 'Business'
        - `party_type` string
        - `organization_name` string
        - `entity_type` string
        - `first_name` string
        - `last_name` string
        - `addresses` TypeLienDebtorsItemAddressesItem[]
          - `full_address` string
          - `address_line1` string
          - `address_line2` string, nullable
          - `city` string
          - `state` string
          - `postal_code` string
      - `secured_parties` TypeLienSecuredPartiesItem[], required
        - `name` string
        - `type` 'ORGANIZATION' | 'INDIVIDUAL'
        - `role` string
        - `organization_name` string
        - `addresses` TypeLienSecuredPartiesItemAddressesItem[]
          - `full_address` string
          - `address_line1` string
          - `address_line2` string, nullable
          - `city` string
          - `state` string
          - `postal_code` string
      - `file_number` string, nullable, required — Filing number for the lien
      - `state` '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', required — State where the lien was filed
      - `status` 'created' | 'pending' | 'open' | 'closing' | 'closed' | 'unknown' | 'filed', required — Current status of the lien
      - `filing_date` string, date, nullable, required — Date the lien was filed
      - `updated_date` string, date, nullable — Date the lien was last updated
      - `lapse_date` string, date, nullable — Date the lien lapses/expires
      - `collateral` string, nullable — Description of collateral securing the lien
      - `collateral_type` 'Blanket' | 'Collateral' | 'Unknown' | 'All Assets and Receivables' | 'All Receivables' | 'All Assets' | 'Named Assets' | 'Unavailable'
      - `negative_pledge` boolean — Whether this is a negative pledge
      - `confirmation_number` string, nullable
      - `loan_principal_amount_cents` integer, nullable — Loan principal amount in cents
      - `source` string, uri, nullable — Source URL for the lien data
      - `packet_number` string, nullable
      - `lien_termination` object, nullable — Lien termination details if terminated
      - `liability_cents` integer, nullable — Liability amount in cents
      - `alternative_designation` 'buyer_seller' | 'bailee_bailor' | 'consignee_consignor' | 'lessee_lessor' | 'licensee_licensor'
      - `status_category` 'active' | 'open' | 'closed' | 'terminated' | 'processing' | 'unknown', required — Categorized status of the lien
      - `owner_id` string, uuid, required — Polymorphic owner ID (typically business_id)
      - `owner_type` string, required — Polymorphic owner type (typically Business)
      - `filed_by_account` boolean, nullable — Whether the lien was filed by the account
      - `documents` TypeDocument[], required — Associated lien documents
        - `object` 'document', required
        - `id` string, uuid, 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, uri, required — URL to download the document
        - `created_at` string, date-time, required
        - `source` TypeDocumentSource
          - `type` string — Source type (e.g., registration)
          - `id` string, uuid — Source record ID
          - `metadata` object — Additional source metadata
        - `filing_date` string, date-time, nullable
        - `metadata` object — Additional document metadata
    - `criminal_records` TypeCriminalHistoryRecord[]
      - `object` 'criminal_history/record', required
      - `id` string, uuid, required
      - `category` string, required
      - `state` string, nullable
      - `person` TypeCriminalHistoryRecordPerson
        - `dob` string, date, nullable
      - `cases` TypeCriminalHistoryCase[], required
        - `object` 'criminal_history/case', required
        - `arrest_date` string, date, nullable
        - `case_number` string, nullable
        - `case_type` string, nullable
        - `court_county` string, nullable
        - `court_name` string, nullable
        - `file_date` string, date, nullable
        - `status` string, nullable
        - `title` string, nullable
        - `arresting_agency` string, nullable
        - `charges` TypeCriminalHistoryCharge[], required
          - `object` 'criminal_history/charge', required
          - `category` string, nullable
          - `charge_type` string, nullable
          - `city` string, nullable
          - `county` string, nullable
          - `description` string, nullable
          - `dispositions` TypeCriminalHistoryChargeDispositionsItem[]
            - `disposition` string, nullable
            - `disposition_date` string, date, nullable
            - `disposition_type` string, nullable
          - `legal_code` string, nullable
          - `offense_date` string, date, nullable
          - `sentences` TypeCriminalHistoryChargeSentencesItem[], nullable
            - `details` string
          - `state` string, nullable
          - `subcategory` string, nullable
          - `subsubcategory` string, nullable
    - `sources` TypeSource[]
      - `id` string, uuid, 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` object, required
  - `phone_numbers` TypePhoneNumber[]
    - `object` 'phone_number'
    - `id` string, uuid — Unique identifier for the phone number resource.
    - `number` string
    - `contact_type` string, nullable
    - `recommended` boolean, nullable
  - `email_addresses` TypeEmailAddress[]
    - `object` 'email_address', required
    - `id` string, uuid, required
    - `email` string, required
    - `submitted` boolean, required
    - `sources` TypeSource[]
      - `id` string, uuid, 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` object, required
    - `domain` string — Domain portion of the email address. Included when email risk data is present.
    - `valid` boolean — Whether the email address is valid. Included when email risk data is present.
    - `deliverability` string — Likelihood that mail sent to this address will be delivered. Included when email risk data is present.
    - `disposable` boolean — Whether the email belongs to a disposable / temporary email service. Included when email risk data is present.
    - `address_type` 'disposable' | 'free' | 'private' — Classification of the email address. Included when email risk data is present.
    - `business_id` string, uuid — ID of the business the email address is associated with. Included when email risk data is present.
    - `domain_age` string, date-time, nullable — UTC datetime the email's domain was first registered. Included when email risk data is present.
    - `first_seen` string, date-time, nullable — UTC datetime the email was first observed by our data provider. Included when email risk data is present.
    - `rating` TypeEmailRating
      - `risk_rating` 'low' | 'moderate' | 'high', required
      - `indicators` TypeEmailIndicator[]
        - `type` 'email_validity' | 'email_deliverability' | 'email_domain_reputation' | 'email_domain_configuration' | 'email_account_activity' | 'email_data_breach_exposure' | 'email_address_type', required
        - `name` string, required
        - `rating` 'positive' | 'negative' | 'neutral', required
        - `value` string, required
        - `description` string, required
  - `profiles` TypeProfile[]
    - `object` string, required
    - `id` string, uuid, required
    - `type` 'facebook' | 'google' | 'yelp' | 'bbb' | 'linkedin', required
    - `external_id` string, nullable
    - `url` string, uri, required
    - `metadata` TypeProfileMetadata
      - `name` string
      - `city` string
      - `state` string
      - `full_address` string
      - `website_urls` string[]
      - `latitude` number, double
      - `longitude` number, double
      - `phone_number` string
      - `categories` string[]
      - `reviews` TypeProfileMetadataReviewsItem[]
        - `rating` number, double
        - `posted_at` string, date-time
      - `recent_posts` object[]
      - `recent_reviews` object[]
    - `rating` number, double, nullable
    - `rating_count` integer, nullable
  - `registrations` TypeRegistration[]
    - `object` string, required
    - `id` string, uuid, required
    - `business_id` string, uuid, required
    - `name` string, required
    - `status` string, required
    - `sub_status` string, nullable
    - `status_details` string, nullable
    - `jurisdiction` string, nullable, required — 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.
    - `jurisdiction_details` TypeRegistrationJurisdictionDetails — The sub-national jurisdiction for international registrations. `null` for US registrations.
      - `name` string, nullable
      - `abbr` string, nullable
      - `authority` string, nullable — The registry authority for the jurisdiction.
    - `entity_type` string, nullable, required
    - `file_number` string, required
    - `country_code` string — `US` for domestic registrations, or an ISO 3166-1 alpha-2 code for international registrations (e.g., `FR`, `DE`, `GB`).
    - `addresses` string[]
    - `officers` object[]
    - `registered_agent` object, nullable
    - `registration_date` string, date, nullable
    - `state` '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', required — The US state for the registration. `null` for international registrations.
    - `source` string, uri, nullable
    - `submitted` boolean — `true` if you submitted the registration, `false` if Middesk sourced it.
  - `orders` TypeOrder[]
    - `object` string, required
    - `id` string, uuid, required
    - `status` 'created' | 'pending' | 'audited' | 'completed' | 'approved' | 'rejected', required
    - `business_id` string, uuid, required
    - `subproducts` TypeOrderSubproductsItem[]
    - `completed_at` string, date-time, nullable
    - `monitoring` boolean
    - `product` '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', required
    - `requester` TypeOrderRequester
      - `name` string, nullable
      - `type` 'account' | 'user' | 'api_key'
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `industry_classification` TypeIndustryClassification
    - `object` 'industry_classification', required
    - `id` string, uuid, required
    - `status` 'pending' | 'completed' | 'failed', required
    - `categories` TypeIndustryClassificationCategoriesItem[], required
      - `classification_system` 'NAICS' | 'MCC' | 'Prohibited'
      - `name` string — Industry name
      - `sector` string, nullable — Industry sector in CONSTANT_CASE
      - `category` string — Industry category in CONSTANT_CASE
      - `score` number, double — Classification confidence score (0.0 to 1.0)
      - `high_risk` boolean — Whether this industry is considered high risk
      - `naics_codes` string[] — NAICS (2022) classification codes
      - `sic_codes` string[] — SIC classification codes
      - `mcc_codes` string[] — MCC classification codes
      - `prohibited_labels` string[], nullable — Prohibited classification labels if applicable
      - `risk_program_flags` TypeRiskProgramFlag[] — Card-network merchant-risk program flags (Mastercard SMRP, Visa VIRP) this category was flagged under. Present only on risk orders; omitted otherwise. Empty when the risk order flagged none.
        - `program` 'SMRP' | 'VIRP', required — The card-network merchant-risk program.
        - `program_category` string, required — The network listing category (e.g. `crypto`, `pharmacy`, `gambling`).
        - `tier` TypeRiskProgramFlagTier — VIRP tier severity. Present only for VIRP flags; absent for SMRP (which is untiered).
          - `level` integer, required — VIRP tier severity level.
          - `harm_type` 'health_safety' | 'financial' | 'regulatory_deceptive', required
    - `created_at` string, date-time, required
    - `completed_at` string, date-time, nullable
    - `website` TypeIndustryClassificationWebsite
      - `status` 'online' | 'offline' | 'unknown'
      - `parked` boolean
  - `monitor` TypeMonitor
    - `object` string, required
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `event_types` TypeMonitorEventTypesItem[], required
      - `type` string
      - `enabled_at` string, date-time, nullable
      - `status` 'active' | 'unavailable' | 'pending'
  - `tax_exempt_organization` TypeTaxExemptOrganization
    - `object` string
    - `id` string, uuid
    - `ein` string
    - `name` string
    - `section` string, nullable
    - `ruling_date` string, date, nullable
    - `tax_period` string, date, nullable
    - `revoked_at` string, date-time, nullable
  - `fmcsa_registrations` TypeFmcsaRegistration[]
    - `object` 'fmcsa_registration', required
    - `id` string, uuid, required
    - `dot_number` string, required — Department of Transportation (DOT) number
    - `legal_name` string, required — Legal name of the carrier
    - `dba_name` string, nullable — Doing Business As name
    - `source` string, uri, required — Source URL for the FMCSA registration data
    - `addresses` string[], required — List of carrier addresses
  - `loans` TypeLoan[], nullable
    - `object` 'loan', required
    - `id` string, uuid, required
    - `issued_date` string, date, nullable
    - `amount` number, double, nullable
    - `lender` string, nullable
    - `details` TypeLoanDetails
      - `gender` string, nullable
      - `veteran` string, nullable
      - `naics_code` TypeLoanDetailsNaicsCode
        - `code` integer
        - `title` string
        - `description` string
      - `non_profit` string, nullable
      - `business_type` string, nullable
      - `jobs_reported` string, nullable
      - `race_ethnicity` string, nullable
  - `litigations` TypeLitigation[]
    - `object` string, required
    - `id` string, uuid, required
    - `case_name` string, required
    - `case_number` string, required
    - `case_status` 'OPEN' | 'CLOSED' | 'UNKNOWN', required
    - `case_type` string, required
    - `filing_date` string, date, required
    - `judgments` TypeJudgment[]
      - `id` string, uuid, required
      - `litigation_id` string, uuid, required
      - `docket_entry_date` string, date, required
      - `text` string, required
      - `amount_cents` integer, nullable — The judgment amount in cents. For example, 5000000 represents $50,000.00. Null if no monetary amount is associated with the judgment.
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `jurisdiction` string
    - `jurisdiction_state` string, nullable
    - `party_type` string, required
    - `parties` TypeLitigationPartiesItem[]
      - `id` string, uuid, required
      - `name` string, required
      - `role` 'Plaintiff' | 'Defendant' | 'Cross-Plaintiff' | 'Cross-Defendant', required
      - `litigation_id` string, uuid, required
      - `created_at` string, date-time
      - `updated_at` string, date-time
  - `policy_results` TypePolicyResult[]
    - `object` string
    - `id` string — Policy result ID
    - `result` string — Policy result outcome
    - `created_at` string — Creation timestamp
    - `matched` string, nullable — Match status
    - `executed` boolean — Execution status
    - `name` string, nullable — Policy name
    - `details` object — Additional details
    - `owner_id` string — Owner ID
    - `owner_type` string — Owner type
    - `business_id` string — Business ID
    - `type_of` string — Type of policy result
    - `policy_action_results` TypePolicyActionResult[]
      - `object` string
      - `id` string — Policy action result ID
      - `details` object — Action details
      - `executed` boolean — Execution status
      - `policy_action` TypePolicyActionResultPolicyAction
        - `id` string — Policy action ID
        - `action_type` string — Type of action
        - `options` object — Action options
        - `policy_version_id` string — Policy version ID
  - `politically_exposed_person_screening` TypePoliticallyExposedPersonScreening
    - `object` string, required
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `results` TypePoliticallyExposedPersonScreeningResultsItem[], required
      - `object` 'politically_exposed_person_screening_result'
      - `id` string, uuid
      - `aliases` string[]
      - `birth_name` string, nullable
      - `birth_place` string, nullable
      - `citizenship_country` string, nullable
      - `dob` string, nullable
      - `employers` string[]
      - `hit_type` 'direct' | 'direct_alias' | 'association'
      - `memberships` object[]
      - `name` string
      - `professional_history` string[]
      - `score` number, double
      - `source_urls` string[]
      - `stakeholders` object[]
    - `settings` TypePoliticallyExposedPersonScreeningSettings
      - `people` string
      - `match_score` 'LOW' | 'MEDIUM' | 'HIGH'
  - `adverse_media_screening` TypeAdverseMediaScreening
    - `object` string, required
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `results` TypeAdverseMediaScreeningResultsItem[], required
      - `object` 'adverse_media_screening_result'
      - `id` string, uuid
      - `risk_scores` object
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `match_score` number, double
      - `items` TypeAdverseMediaScreeningResultsItemItemsItem[]
        - `object` 'adverse_media_item'
        - `source_name` string
        - `title` string
        - `url` string, uri
        - `flags` TypeAdverseMediaScreeningResultsItemItemsItemFlags
          - `risks` TypeAdverseMediaScreeningResultsItemItemsItemFlagsRisksItem[]
            - `name` string
            - `confidence_level` 'low' | 'moderate' | 'high'
          - `sentiments` TypeAdverseMediaScreeningResultsItemItemsItemFlagsSentimentsItem[]
            - `name` 'positive' | 'negative' | 'neutral'
            - `confidence_level` 'low' | 'moderate' | 'high'
        - `created_at` string, date-time
        - `updated_at` string, date-time
    - `exclusion_settings` TypeAdverseMediaScreeningExclusionSettings
      - `criteria_match_threshold` number, double
      - `max_people_screened` integer
      - `max_names_screened` integer
      - `people` object[]
  - `signal` TypeSignal
    - `object` string, required
    - `id` string, uuid, required
    - `name` string, required
    - `tin` string, nullable
    - `external_id` string, nullable
    - `model_slug` string
    - `score` number, double, nullable
    - `business_id` string, uuid, nullable
    - `batch_id` string, uuid, nullable
    - `requester` TypeSignalRequester
      - `id` string, uuid, required
      - `type` string, required
      - `name` string, required
    - `reasons` TypeSignalReasonsItem[]
      - `category` 'identification' | 'verification' | 'evaluation', required
      - `group` string, required
      - `description` string, required
      - `code` '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', required
      - `importance` number, double
    - `addresses` string[]
    - `people` string[]
    - `created_at` string, date-time, required
  - `submitted` TypeSubmittedAttribute
    - `object` string, required
    - `name` string, required
    - `entity_type` string, nullable
    - `addresses` object[]
    - `orders` TypeSubmittedAttributeOrdersItem[], nullable
      - `product` string
    - `people` object[]
    - `phone_numbers` object[], nullable
    - `email_addresses` object[], nullable
    - `tags` string[], nullable
    - `external_id` string, nullable
    - `unique_external_id` string, nullable
    - `tin` object, nullable
    - `website` object, nullable
    - `assignee_id` string, nullable
    - `formation` object, nullable
    - `names` object[], nullable
    - `profiles` object[], nullable
  - `subscription` TypeSubscription
    - `object` string
    - `id` string, uuid
  - `subscription_availability` TypeBusinessSubscriptionAvailability
    - `bankruptcy` 'subscribable' | 'account_unsubscribable'
    - `certification` 'subscribable' | 'account_unsubscribable'
    - `registration` 'subscribable' | 'account_unsubscribable'
    - `tin` 'subscribable' | 'account_unsubscribable'
    - `watchlist_result` 'subscribable' | 'account_unsubscribable'
    - `lien` 'subscribable' | 'account_unsubscribable'
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `404` — business not found

---

[API](https://skmtc.net/middesk/apis/middesk-api.md) · [All operations](https://skmtc.net/middesk/apis/middesk-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/middesk/middesk-api/versions/9882e52b445b/schema)