Middesk subpackage_businesses API
The subpackage_businesses API from Middesk — 3 operation(s) for subpackage_businesses.
The subpackage_businesses API from Middesk — 3 operation(s) for subpackage_businesses.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/middesk-subpackage-businesses-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Middesk subpackage_actions Subpackage Businesses API
version: 1.0.0
servers:
- url: https://api.middesk.com
description: Default
tags:
- name: subpackage_businesses
paths:
/v1/businesses:
get:
operationId: list-businesses
summary: List businesses
tags:
- subpackage_businesses
parameters:
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: businesses list
content:
application/json:
schema:
$ref: '#/components/schemas/type_businesses_ListBusinessesResponse'
post:
operationId: create-business
summary: Create a business
tags:
- subpackage_businesses
parameters:
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'201':
description: business created
content:
application/json:
schema:
$ref: '#/components/schemas/type__Business'
'422':
description: invalid request
content:
application/json:
schema:
description: Any type
requestBody:
content:
application/json:
schema:
type: object
properties:
name:
type: string
tin:
$ref: '#/components/schemas/type_businesses_BusinessRequestParamTin'
addresses:
type: array
items:
$ref: '#/components/schemas/type_businesses_BusinessRequestParamAddressesItem'
website:
$ref: '#/components/schemas/type_businesses_BusinessRequestParamWebsite'
description: Website information for the business. Required when name and addresses are not provided when ordering the web_analysis and/or industry_classification subproducts.
people:
type: array
items:
$ref: '#/components/schemas/type__SubmittedPerson'
external_id:
type: string
unique_external_id:
type: string
tags:
type: array
items:
type: string
connection_id:
type: string
description: The ID of a connection to use as the source for this business. Pre-fills the business name and address from the connection.
orders:
type: array
items:
$ref: '#/components/schemas/type_businesses_BusinessRequestParamOrdersItem'
description: Orders to place against the business at creation time. Each order specifies a product (and optional subproducts/options) to run.
required:
- name
- addresses
/v1/businesses/{id}:
get:
operationId: get-business
summary: Retrieve a business
tags:
- subpackage_businesses
parameters:
- name: id
in: path
description: Business ID
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: business found
content:
application/json:
schema:
$ref: '#/components/schemas/type__Business'
'404':
description: business not found
content:
application/json:
schema:
$ref: '#/components/schemas/type__ErrorResponse'
patch:
operationId: update-business
summary: Update a business
tags:
- subpackage_businesses
parameters:
- name: id
in: path
description: Business ID
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: business updated
content:
application/json:
schema:
$ref: '#/components/schemas/type__Business'
'404':
description: business not found
content:
application/json:
schema:
$ref: '#/components/schemas/type__ErrorResponse'
requestBody:
content:
application/json:
schema:
type: object
properties:
name:
type: string
status:
$ref: '#/components/schemas/type_businesses_BusinessUpdateParamStatus'
description: Status to set for the business (only final statuses allowed)
tin:
$ref: '#/components/schemas/type_businesses_BusinessUpdateParamTin'
addresses:
type: array
items:
$ref: '#/components/schemas/type_businesses_BusinessUpdateParamAddressesItem'
people:
type: array
items:
$ref: '#/components/schemas/type__SubmittedPerson'
external_id:
type: string
unique_external_id:
type: string
tags:
type: array
items:
type: string
/v1/businesses/{id}/pdf:
get:
operationId: get-business-pdf
summary: Retrieve a business PDF
tags:
- subpackage_businesses
parameters:
- name: id
in: path
description: Business ID
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: Successful response
'404':
description: business not found
content:
application/json:
schema:
description: Any type
components:
schemas:
type__Registration:
type: object
properties:
object:
type: string
id:
type: string
format: uuid
business_id:
type: string
format: uuid
name:
type: string
status:
type: string
sub_status:
type:
- string
- 'null'
status_details:
type:
- string
- 'null'
jurisdiction:
type: string
entity_type:
type: string
file_number:
type: string
addresses:
type: array
items:
type: string
officers:
type: array
items:
type: object
additionalProperties:
description: Any type
registered_agent:
type: object
additionalProperties:
description: Any type
registration_date:
type: string
format: date
state:
$ref: '#/components/schemas/type__RegistrationState'
source:
type: string
format: uri
required:
- object
- id
- business_id
- name
- status
- jurisdiction
- entity_type
- file_number
- state
title: Registration
type__ReviewTaskStatus:
type: string
enum:
- success
- failure
- warning
- neutral
title: ReviewTaskStatus
type__IndustryClassificationWebsiteStatus:
type: string
enum:
- online
- offline
- unknown
title: IndustryClassificationWebsiteStatus
type__Review:
type: object
properties:
object:
$ref: '#/components/schemas/type__ReviewObject'
id:
type: string
format: uuid
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
completed_at:
type:
- string
- 'null'
format: date-time
tasks:
type: array
items:
$ref: '#/components/schemas/type__ReviewTask'
assignee:
oneOf:
- $ref: '#/components/schemas/type__User'
- type: 'null'
required:
- object
- id
- created_at
- updated_at
- tasks
title: Review
type__LienObject:
type: string
enum:
- lien
title: LienObject
type__IndustryClassificationCategoriesItem:
type: object
properties:
classification_system:
$ref: '#/components/schemas/type__IndustryClassificationCategoriesItemClassificationSystem'
name:
type: string
description: Industry name
sector:
type:
- string
- 'null'
description: Industry sector in CONSTANT_CASE
category:
type: string
description: Industry category in CONSTANT_CASE
score:
type: number
format: double
description: Classification confidence score (0.0 to 1.0)
high_risk:
type: boolean
description: Whether this industry is considered high risk
naics_codes:
type: array
items:
type: string
description: NAICS (2022) classification codes
sic_codes:
type: array
items:
type: string
description: SIC classification codes
mcc_codes:
type: array
items:
type: string
description: MCC classification codes
prohibited_labels:
type:
- array
- 'null'
items:
type: string
description: Prohibited classification labels if applicable
title: IndustryClassificationCategoriesItem
type__EmailRating:
type: object
properties:
risk_rating:
$ref: '#/components/schemas/type__EmailRatingRiskRating'
indicators:
type: array
items:
$ref: '#/components/schemas/type__EmailIndicator'
required:
- risk_rating
title: EmailRating
type__AddressIndicatorRating:
type: string
enum:
- positive
- negative
- neutral
title: AddressIndicatorRating
type__ReviewTask:
type: object
properties:
category:
$ref: '#/components/schemas/type__ReviewTaskCategory'
key:
$ref: '#/components/schemas/type__ReviewTaskKey'
label:
$ref: '#/components/schemas/type__ReviewTaskLabel'
message:
type: string
name:
type: string
status:
$ref: '#/components/schemas/type__ReviewTaskStatus'
sub_label:
type: string
sources:
type: array
items:
$ref: '#/components/schemas/type__Source'
required:
- category
- key
- label
- message
- name
- status
- sub_label
- sources
title: ReviewTask
type__LienCollateralType:
type: string
enum:
- Blanket
- Collateral
- Unknown
- All Assets and Receivables
- All Receivables
- All Assets
- Named Assets
- Unavailable
title: LienCollateralType
type_businesses_BusinessRequestParamOrdersItemOptions:
type: object
properties:
person_match:
type: boolean
description: When true on a `tin` order, enables person-name matching against IRS records.
description: Per-order configuration flags.
title: BusinessRequestParamOrdersItemOptions
type__AdverseMediaScreening:
type: object
properties:
object:
type: string
id:
type: string
format: uuid
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
results:
type: array
items:
$ref: '#/components/schemas/type__AdverseMediaScreeningResultsItem'
exclusion_settings:
$ref: '#/components/schemas/type__AdverseMediaScreeningExclusionSettings'
required:
- object
- id
- created_at
- updated_at
- results
title: AdverseMediaScreening
type__LienSecuredPartiesItemType:
type: string
enum:
- ORGANIZATION
- INDIVIDUAL
title: LienSecuredPartiesItemType
type__MonitorEventTypesItemStatus:
type: string
enum:
- active
- unavailable
- pending
title: MonitorEventTypesItemStatus
type__CriminalHistoryRecordPerson:
type: object
properties:
dob:
type:
- string
- 'null'
format: date
title: CriminalHistoryRecordPerson
type__AddressDeliverabilityAnalysis:
type: object
properties:
message:
type: string
sub_type:
$ref: '#/components/schemas/type__AddressDeliverabilityAnalysisSubType'
sub_key:
$ref: '#/components/schemas/type__AddressDeliverabilityAnalysisSubKey'
title: AddressDeliverabilityAnalysis
type__IndustryClassificationCategoriesItemClassificationSystem:
type: string
enum:
- NAICS
- MCC
- Prohibited
title: IndustryClassificationCategoriesItemClassificationSystem
type__WebsiteRating:
type: object
properties:
indicators:
type: array
items:
$ref: '#/components/schemas/type__WebsiteIndicator'
quality_rating:
$ref: '#/components/schemas/type__WebsiteRatingQualityRating'
required:
- quality_rating
title: WebsiteRating
type__EmailAddressAddressType:
type: string
enum:
- disposable
- free
- private
description: Classification of the email address. Included when email risk data is present.
title: EmailAddressAddressType
type__LienDebtorsItemType:
type: string
enum:
- ORGANIZATION
- INDIVIDUAL
- UNKNOWN
- Business
title: LienDebtorsItemType
type__SubmittedAddressFull:
type: object
properties:
full_address:
type: string
description: Complete address as a single string
required:
- full_address
title: SubmittedAddressFull
type__WebsitePhoneNumber:
type: object
properties:
object:
$ref: '#/components/schemas/type__WebsitePhoneNumberObject'
id:
type: string
format: uuid
number:
type: string
contact_type:
type:
- string
- 'null'
recommended:
type:
- boolean
- 'null'
submitted:
type: boolean
sources:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/type__Source'
title: WebsitePhoneNumber
type__Document:
type: object
properties:
object:
$ref: '#/components/schemas/type__DocumentObject'
id:
type: string
format: uuid
document_type:
type: string
description: 'Type of document. Common values include: Initial_Filing, Certificate of Good Standing, Articles of Incorporation, Initial Filing (UCC1), Amendment (UCC3)'
filename:
type: string
description: Name of the document file
content_type:
type: string
description: MIME type of the document
size:
type: integer
description: File size in bytes
download_url:
type: string
format: uri
description: URL to download the document
created_at:
type: string
format: date-time
source:
$ref: '#/components/schemas/type__DocumentSource'
filing_date:
type:
- string
- 'null'
format: date-time
metadata:
type: object
additionalProperties:
description: Any type
description: Additional document metadata
required:
- object
- id
- document_type
- filename
- content_type
- size
- download_url
- created_at
title: Document
type__CertificationCertificationType:
type: string
enum:
- federal
- self_certified
title: CertificationCertificationType
type__BankruptcyObject:
type: string
enum:
- bankruptcy
title: BankruptcyObject
type_businesses_BusinessRequestParamOrdersItemProduct:
type: string
enum:
- 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
description: The product to order.
title: BusinessRequestParamOrdersItemProduct
type__CertificationExternalSourcesItem:
type: object
properties:
organization:
type: string
link:
type: string
title: CertificationExternalSourcesItem
type__BusinessSubscriptionAvailabilityRegistration:
type: string
enum:
- subscribable
- account_unsubscribable
title: BusinessSubscriptionAvailabilityRegistration
type__WatchlistResult:
type: object
properties:
object:
$ref: '#/components/schemas/type__WatchlistResultObject'
id:
type: string
format: uuid
status:
type: string
entity_name:
type: string
entity_aliases:
type: array
items:
type: string
listed_at:
type:
- string
- 'null'
format: date-time
agency_information_url:
type: string
agency_list_url:
type: string
score:
type:
- number
- 'null'
format: double
addresses:
type: array
items:
$ref: '#/components/schemas/type__WatchlistResultAddressesItem'
url:
type:
- string
- 'null'
format: uri
list_country:
type: string
list_url:
type:
- string
- 'null'
format: uri
list_region:
type: string
categories:
type: array
items:
type: string
required:
- object
- id
- status
- entity_name
- entity_aliases
- agency_information_url
- agency_list_url
- score
title: WatchlistResult
type__LienSecuredPartiesItem:
type: object
properties:
name:
type: string
type:
$ref: '#/components/schemas/type__LienSecuredPartiesItemType'
role:
type: string
organization_name:
type: string
addresses:
type: array
items:
$ref: '#/components/schemas/type__LienSecuredPartiesItemAddressesItem'
title: LienSecuredPartiesItem
type__AddressPropertyType:
type: string
enum:
- commercial
- residential
title: AddressPropertyType
type__AddressRatingRiskRating:
type: string
enum:
- low
- moderate
- high
- not_available
title: AddressRatingRiskRating
type__ErrorResponseErrorsItem:
type: object
properties:
message:
type: string
required:
- message
title: ErrorResponseErrorsItem
type__OrderRequesterType:
type: string
enum:
- account
- user
- api_key
title: OrderRequesterType
type__CriminalHistoryCharge:
type: object
properties:
object:
$ref: '#/components/schemas/type__CriminalHistoryChargeObject'
category:
type:
- string
- 'null'
charge_type:
type:
- string
- 'null'
city:
type:
- string
- 'null'
county:
type:
- string
- 'null'
description:
type:
- string
- 'null'
dispositions:
type: array
items:
$ref: '#/components/schemas/type__CriminalHistoryChargeDispositionsItem'
legal_code:
type:
- string
- 'null'
offense_date:
type:
- string
- 'null'
format: date
sentences:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/type__CriminalHistoryChargeSentencesItem'
state:
type:
- string
- 'null'
subcategory:
type:
- string
- 'null'
subsubcategory:
type:
- string
- 'null'
required:
- object
title: CriminalHistoryCharge
type__BusinessItemStatus:
type: string
enum:
- open
- pending
- in_audit
- in_review
- approved
- rejected
description: Current status of the business verification
title: BusinessItemStatus
type__Litigation:
type: object
properties:
object:
type: string
id:
type: string
format: uuid
case_name:
type: string
case_number:
type: string
case_status:
$ref: '#/components/schemas/type__LitigationCaseStatus'
case_type:
type: string
filing_date:
type: string
format: date
judgments:
type: array
items:
$ref: '#/components/schemas/type__Judgment'
jurisdiction:
type: string
jurisdiction_state:
type:
- string
- 'null'
party_type:
type: string
parties:
type: array
items:
$ref: '#/components/schemas/type__LitigationPartiesItem'
required:
- object
- id
- case_name
- case_number
- case_status
- case_type
- filing_date
- party_type
title: Litigation
type__AdverseMediaScreeningResultsItemItemsItemObject:
type: string
enum:
- adverse_media_item
title: AdverseMediaScreeningResultsItemItemsItemObject
type__PoliticallyExposedPersonScreeningResultsItemObject:
type: string
enum:
- politically_exposed_person_screening_result
title: PoliticallyExposedPersonScreeningResultsItemObject
type__ReviewTaskCategory:
type: string
enum:
- 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
title: ReviewTaskCategory
type__AddressState:
type: string
enum:
- 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
title: AddressState
type__PolicyActionResultPolicyAction:
type: object
properties:
id:
type: string
description: Policy action ID
action_type:
type: string
description: Type of action
options:
type: object
additionalProperties:
description: Any type
description: Action options
policy_version_id:
type: string
description: Policy version ID
title: PolicyActionResultPolicyAction
type__BankruptcyDebtorsItem:
type: object
properties:
name:
type: string
title: BankruptcyDebtorsItem
type__AddressRating:
type: object
properties:
indicators:
type: array
items:
$ref: '#/components/schemas/type__AddressIndicator'
risk_rating:
$ref: '#/components/schemas/type__AddressRatingRiskRating'
required:
- risk_rating
title: AddressRating
type__WebsiteStatus:
type: string
enum:
- online
- offline
- unknown
title: WebsiteStatus
type__CertificationObject:
type: string
enum:
- certification
title: CertificationObject
type__FmcsaRegistrationObject:
type: string
enum:
- fmcsa_registration
title: FmcsaRegistrationObject
type__AdverseMediaScreeningResultsItemItemsItemFlagsRisksItemConfidenceLevel:
type: string
enum:
- low
- moderate
- high
title: AdverseMediaScreeningResultsItemItemsItemFlagsRisksItemConfidenceLevel
type__AdverseMediaScreeningResultsItemItemsItemFlags:
type: object
properties:
risks:
type: array
items:
$ref: '#/components/schemas/type__AdverseMediaScreeningResultsItemItemsItemFlagsRisksItem'
sentiments:
type: array
items:
$ref: '#/components/schemas/type__AdverseMediaScreeningResultsItemItemsItemFlagsSentimentsItem'
title: AdverseMediaScreeningResultsItemItemsItemFlags
type__ProfileMetadataReviewsItem:
type: object
properties:
rating:
type: number
format: double
posted_at:
type: string
format: date-time
title: ProfileMetadataReviewsItem
type__BusinessSubscriptionAvailabilityLien:
type: string
enum:
- subscribable
- account_unsubscribable
title: BusinessSubscriptionAvailabilityLien
type__AddressDeliverabilityAnalysisSubKey:
type: string
enum:
- deliverable
- undeliverable
- unknown
title: AddressDeliverabilityAnalysisSubKey
type__BusinessItem:
type: object
properties:
object:
type: string
id:
type: string
format: uuid
external_id:
type:
- string
- 'null'
unique_external_id:
type:
- string
- 'null'
name:
type: string
status:
$ref: '#/components/schemas/type__BusinessItemStatus'
description: Current status of the business verification
tags:
type: array
items:
type: string
review:
oneOf:
- $ref: '#/components/schemas/type__Review'
- type: 'null'
assignee:
oneOf:
- $ref: '#/components/schemas/type__User'
- type: 'null'
website:
oneOf:
- $ref: '#/components/schemas/type__BusinessItemWebsite'
- type: 'null'
orders:
type: array
items:
$ref: '#/components/schemas/type__Order'
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
required:
- object
- id
- name
- status
- created_at
- updated_at
description: Simplified business object returned in list endpoints
title: BusinessItem
type__BusinessSubscriptionAvailability:
type: object
properties:
bankruptcy:
$ref: '#/components/schemas/type__BusinessSubscriptionAvailabilityBankruptcy'
certification:
$ref: '#/components/schemas/type__BusinessSubscriptionAvailabilityCertification'
registration:
$ref: '#/components/schemas/type__BusinessSubscriptionAvailabilityRegistration'
tin:
$ref: '#/components/schemas/type__BusinessSubscriptionAvailabilityTin'
watchlist_result:
$ref: '#/components/schemas/type__BusinessSubscriptionAvailabilityWatchlistResult'
lien:
$ref: '#/components/schemas/type__BusinessSubscriptionAvailabilityLien'
title: BusinessSubscriptionAvailability
type__SubmittedPerson:
type: object
properties:
name:
type: string
description: Full name of the person
title:
type: string
description: Job title or role
email:
type: string
format: email
phone:
type: string
required:
- name
title: SubmittedPerson
type__BusinessSubscriptionAvailabilityBankruptcy:
type: string
enum:
- subscribable
- account_unsubscribable
title: BusinessSubscriptionAvailabilityBankruptcy
type__DocumentSource:
type: object
properties:
type:
type: string
description: Source type (e.g., registration)
id:
type: string
format: uuid
description: Source record ID
metadata:
type: object
additionalProperties:
description: Any type
description: Additional source metadata
title: DocumentSource
type__LoanObject:
type: string
enum:
- loan
title: LoanObject
type__AdverseMediaScreeningResultsItemItemsItemFlagsSentimentsItemConfidenceLevel:
type: string
enum:
- low
- moderate
- high
title: AdverseMediaScreeningResultsItemItemsItemFlagsSentimentsItemConfidenceLevel
type__AddressDeliverabilityAnalysisSubType:
type: string
enum:
- Deliverable
- Undeliverable
- Unknown
title: AddressDeliverabilityAnalysisSubType
type__MonitorEventTypesItem:
type: object
properties:
type:
type: string
enabled_at:
type:
- string
- 'null'
format: date-time
status:
$ref: '#/components/schemas/type__MonitorEventTypesItemStatus'
title: MonitorEventTypesItem
type__EmailIndicatorRating:
type: string
enum:
- positive
- negative
- neutral
title: EmailIndicatorRating
type__IndustryClassificationObject:
type: string
enum:
- industry_classification
title: IndustryClassificationObject
type_businesses_BusinessUpdateParamStatus:
type: string
enum:
- in_review
- approved
- rejected
description: Status to set for the business (only final statuses allowed)
title: BusinessUpdateParamStatus
type__OrderSubproductsItem:
type: string
enum:
- Articles of Incorporation
- Certificate of Good Standing
- Articles of Incorporation with Certificate of Good Standing fallback
- ucc_documents
- web_analysis
- industry_classification
title: OrderSubproductsItem
type__PolicyResult:
type: object
prop
# --- truncated at 32 KB (101 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/middesk/refs/heads/main/openapi/middesk-subpackage-businesses-api-openapi.yml