How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Middesk subpackage_businesses API

The subpackage_businesses API from Middesk — 3 operation(s) for subpackage_businesses.

Middesk subpackage_businesses API is one of 28 APIs that Middesk publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 5 operations across 3 paths, and defines 190 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://api.middesk.com.

5 operations 3 paths 190 schemas 3 GET1 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.middesk.com/v1/
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Middesk subpackage_businesses API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearer_auth).

Paths & Operations 5

Across 3 paths, the API surfaces 5 operations — 3 GET, 1 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

subpackage_businesses 5
GET
/v1/businesses
List businesses
list-businesses 1 param → 200
POST
/v1/businesses
Create a business
create-business 1 param body → 201422
GET
/v1/businesses/{id}
Retrieve a business
get-business 2 params → 200404
PATCH
/v1/businesses/{id}
Update a business
update-business 2 params body → 200404
GET
/v1/businesses/{id}/pdf
Retrieve a business PDF
get-business-pdf 2 params → 200404

Schemas 190

The contract defines 190 schemas that model the data the API accepts and returns. The most detailed are type__Business (43 properties), type__Lien (27 properties), type__Website (26 properties), type__Address (25 properties). Each schema is shown below with its type and property counts.

type__Registration
object
16 properties 9 required
type__ReviewTaskStatus
string
type__IndustryClassificationWebsiteStatus
string
type__Review
object
7 properties 5 required
type__LienObject
string
type__IndustryClassificationCategoriesItem
object
10 properties
type__EmailRating
object
2 properties 1 required
type__AddressIndicatorRating
string
type__ReviewTask
object
8 properties 8 required
type__LienCollateralType
string
type_businesses_BusinessRequestParamOrdersItemOptions
object
Per-order configuration flags.
1 property
type__AdverseMediaScreening
object
6 properties 5 required
type__LienSecuredPartiesItemType
string
type__MonitorEventTypesItemStatus
string
type__CriminalHistoryRecordPerson
object
1 property
type__AddressDeliverabilityAnalysis
object
3 properties
type__IndustryClassificationCategoriesItemClassificationSystem
string
type__WebsiteRating
object
2 properties 1 required
type__EmailAddressAddressType
string
Classification of the email address. Included when email risk data is present.
type__LienDebtorsItemType
string
type__SubmittedAddressFull
object
1 property 1 required
type__WebsitePhoneNumber
object
7 properties
type__Document
object
11 properties 8 required
type__CertificationCertificationType
string
type__BankruptcyObject
string
type_businesses_BusinessRequestParamOrdersItemProduct
string
The product to order.
type__CertificationExternalSourcesItem
object
2 properties
type__BusinessSubscriptionAvailabilityRegistration
string
type__WatchlistResult
object
15 properties 8 required
type__LienSecuredPartiesItem
object
5 properties
type__AddressPropertyType
string
type__AddressRatingRiskRating
string
type__ErrorResponseErrorsItem
object
1 property 1 required
type__OrderRequesterType
string
type__CriminalHistoryCharge
object
13 properties 1 required
type__BusinessItemStatus
string
Current status of the business verification
type__Litigation
object
12 properties 8 required
type__AdverseMediaScreeningResultsItemItemsItemObject
string
type__PoliticallyExposedPersonScreeningResultsItemObject
string
type__ReviewTaskCategory
string
type__AddressState
string
type__PolicyActionResultPolicyAction
object
4 properties
type__BankruptcyDebtorsItem
object
1 property
type__AddressRating
object
2 properties 1 required
type__WebsiteStatus
string
type__CertificationObject
string
type__FmcsaRegistrationObject
string
type__AdverseMediaScreeningResultsItemItemsItemFlagsRisksItemConfidenceLevel
string
type__AdverseMediaScreeningResultsItemItemsItemFlags
object
2 properties
type__ProfileMetadataReviewsItem
object
2 properties
type__BusinessSubscriptionAvailabilityLien
string
type__AddressDeliverabilityAnalysisSubKey
string
type__BusinessItem
object
Simplified business object returned in list endpoints
13 properties 6 required
type__BusinessSubscriptionAvailability
object
6 properties
type__SubmittedPerson
object
4 properties 1 required
type__BusinessSubscriptionAvailabilityBankruptcy
string
type__DocumentSource
object
3 properties
type__LoanObject
string
type__AdverseMediaScreeningResultsItemItemsItemFlagsSentimentsItemConfidenceLevel
string
type__AddressDeliverabilityAnalysisSubType
string
type__MonitorEventTypesItem
object
3 properties
type__EmailIndicatorRating
string
type__IndustryClassificationObject
string
type_businesses_BusinessUpdateParamStatus
string
Status to set for the business (only final statuses allowed)
type__OrderSubproductsItem
string
type__PolicyResult
object
13 properties
type__PersonTitlesItem
object
2 properties
type_businesses_BusinessRequestParamWebsite
object
Website information for the business. Required when name and addresses are not provided when ordering the webanalysis and/or industryclassification subproducts.
1 property
type__BusinessItemWebsite
object
5 properties
type__LienStatusCategory
string
Categorized status of the lien
type__LitigationPartiesItemRole
string
type__LoanDetails
object
7 properties
type__OrderRequester
object
2 properties
type__ReviewTaskKey
string
type__WebsiteDomain
object
8 properties
type_businesses_BusinessRequestParamTin
object
1 property
type__AdverseMediaScreeningResultsItem
object
7 properties
type__BusinessSubscriptionAvailabilityWatchlistResult
string
type__Lien
object
27 properties 14 required
type__AddressIndicatorName
string
type__BankruptcyCaseUpdatesItem
object
3 properties
type__AdverseMediaScreeningResultsItemItemsItemFlagsSentimentsItemName
string
type__Certification
object
12 properties 5 required
type__ErrorResponse
object
1 property 1 required
type__EmailIndicator
object
5 properties 5 required
type__PersonTitlesItemObject
string
type__AdverseMediaScreeningResultsItemItemsItemFlagsSentimentsItem
object
2 properties
type__BusinessStatus
string
Current status of the business verification
type__Formation
object
6 properties 2 required
type__PersonObject
string
type__ReviewTaskLabel
string
type_businesses_ListBusinessesResponse
object
4 properties 2 required
type__LitigationCaseStatus
string
type__WebsiteIndicatorType
string
type__AdverseMediaScreeningExclusionSettings
object
4 properties
type__WebsiteObject
string
type__SubmittedAddressComponent
object
6 properties 3 required
type__PoliticallyExposedPersonScreening
object
6 properties 5 required
type__TaxExemptOrganization
object
8 properties
type__EmailIndicatorType
string
type__WebsiteEmailAddressesItemObject
string
type__Watchlist
object
6 properties 6 required
type__IndustryClassification
object
7 properties 5 required
type__BusinessSupportedDocumentTypesItem
string
type__PoliticallyExposedPersonScreeningResultsItem
object
15 properties
type__OrderStatus
string
type_businesses_BusinessRequestParamAddressesItem
type__CriminalHistoryChargeSentencesItem
object
1 property
type__PolicyActionResult
object
5 properties
type__Person
object
11 properties
type__LienStatus
string
Current status of the lien
type__SignalReasonsItemCategory
string
type__EmailAddressObject
string
type__CriminalHistoryChargeObject
string
type_businesses_BusinessUpdateParamTin
object
1 property
type__RegistrationState
string
type__AdverseMediaScreeningResultsItemItemsItem
object
7 properties
type__SubmittedAddressComponentState
string
type__Tin
object
10 properties 2 required
type__Business
object
43 properties 6 required
type__CriminalHistoryCaseObject
string
type__ReviewObject
string
type__DocumentObject
string
type__OrderProduct
string
type__CriminalHistoryRecordObject
string
type__LienAlternativeDesignation
string
type__WatchlistResultObject
string
type__LienDebtorsItemAddressesItem
object
6 properties
type__Profile
object
8 properties 4 required
type__AddressIndicator
object
5 properties 5 required
type__BusinessSubscriptionAvailabilityCertification
string
type__Judgment
object
7 properties 6 required
type__LienSecuredPartiesItemAddressesItem
object
6 properties
type__FmcsaRegistration
object
7 properties 6 required
type__RequesterType
string
type__Address
object
25 properties 9 required
type__WebsiteEmailAddressesItem
object
5 properties
type__NameType
string
type__CriminalHistoryCase
object
11 properties 2 required
type__LienDebtorsItem
object
8 properties
type_businesses_BusinessRequestParamOrdersItemSubproductsItem
string
type__SignalRequester
object
3 properties 3 required
type__PoliticallyExposedPersonScreeningSettings
object
2 properties
type__SignalReasonsItem
object
5 properties 4 required
type__SubmittedAttributeOrdersItem
object
1 property
type__CriminalHistoryChargeDispositionsItem
object
3 properties
type__IndustryClassificationStatus
string
type__Loan
object
6 properties 2 required
type__PhoneNumberObject
string
type__EmailAddress
object
14 properties 4 required
type__WebsiteIndicatorRating
string
type__IndustryClassificationWebsite
object
2 properties
type__ProfileType
string
type__WebsiteRatingQualityRating
string
type__Bankruptcy
object
9 properties 9 required
type__EmailRatingRiskRating
string
type__LienType
string
Type of lien
type__WebsitePhoneNumberObject
string
type__CriminalHistoryRecord
object
6 properties 4 required
type__WebsitePagesItem
object
3 properties
type__LienState
string
State where the lien was filed
type_businesses_BusinessUpdateParamAddressesItem
type__WebsiteIndicator
object
5 properties 5 required
type__ProfileMetadata
object
12 properties
type__Subscription
object
2 properties
type__AdverseMediaScreeningResultsItemItemsItemFlagsRisksItem
object
2 properties
type__WatchlistSource
object
7 properties 7 required
type__AdverseMediaScreeningResultsItemObject
string
type__SignalReasonsItemCode
string
type_businesses_BusinessRequestParamOrdersItem
object
3 properties 1 required
type__LoanDetailsNaicsCode
object
3 properties
type__Website
object
26 properties 12 required
type__WebsiteAddressesItem
object
10 properties
type__User
object
10 properties 6 required
type__Requester
object
4 properties 4 required
type__PhoneNumber
object
4 properties
type__WatchlistAgency
object
3 properties 3 required
type__Monitor
object
4 properties 4 required
type__Name
object
7 properties 6 required
type__SubmittedAttribute
object
17 properties 2 required
type__WatchlistResultAddressesItem
object
1 property
type__LitigationPartiesItem
object
6 properties 4 required
type__BusinessSubscriptionAvailabilityTin
string
type__PoliticallyExposedPersonScreeningSettingsMatchScore
string
type__Order
object
11 properties 7 required
type__Source
object
3 properties 3 required
type__PoliticallyExposedPersonScreeningResultsItemHitType
string
type__Signal
object
14 properties 4 required
type__WebsiteDomainRegistrar
object
3 properties
type__AddressIndicatorType
string

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

middesk-subpackage-businesses-api-openapi.yml Raw ↑

Other APIs Middesk publishes across the network.

Middesk subpackage_actions API
Middesk subpackage_agents API
Middesk subpackage_applications API
Middesk subpackage_businessBatches API
Middesk subpackage_companies API
Middesk subpackage_connections API
Middesk subpackage_documents API
Middesk subpackage_identities API
Middesk subpackage_informationRequests API
Middesk subpackage_jurisdictions API
Middesk subpackage_liens API
Middesk subpackage_lienTerminations API
Where this information came from

This is an independent, third-party profile of Middesk subpackage_businesses API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.