For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Contact SalesGet Support
HomeGuidesAPI reference
HomeGuidesAPI reference
  • Middesk API
        • Action
        • Address
        • Adverse Media Screening
        • Bankruptcy
        • Business
        • Certification
        • Document
        • Formation
        • Industry Classification
        • Lien
        • Litigation
        • Monitor
        • Names
        • Order
        • Person
        • Policy Result
        • Politically Exposed Persons Screening
        • Registration
        • Review Task
        • Signal
        • Tax exempt organization
        • TIN
        • Watchlist
        • Website
        • Profile
LogoLogo
Contact SalesGet Support
On this page
  • Adverse media screening object
  • Adverse media screening results
  • Adverse media item
  • Adverse media flags
  • Exclusion settings
  • Possible risk categories
Middesk APIBusiness VerificationObject reference

Adverse media screening object

Was this page helpful?
Previous

Bankruptcy object

Next
Built with

This page describes the results Middesk returns after running an adverse media screening on a business.

Adverse media screening object

AttributeTypeDescription
iduuidThe ID of the Adverse Media Screening object
objectstringThe value is adverse_media_screening
resultsobject[]An array of the Adverse Media Screening results associated with this object
created_attimestamp
updated_attimestamp

Adverse media screening results

AttributeTypeDescription
objectstringThe object type. Always adverse_media_screening_result.
iduuidThe ID of the adverse media screening result.
match_scorefloatA score describing how well the matched Person or Name match the result.
itemsobject[]An array of Adverse Media Items.
risk_scoresobjectA hash where each key is one of the risk categories defined below. The value is the confidence level of that risk category. This object may be empty despite Adverse Media items being present.
created_attimestampTimestamp of when the result was created.
updated_attimestampTimestamp of when the result was last updated.

Adverse media item

AttributeTypeDescription
objectstringThe object type. Always adverse_media_item.
source_namestringThe name of the source where the URL was found
titlestringThe title of the media
urlstringThe URL of the media
flagsobjectSee the Flags object defined below
created_attimestamp
updated_attimestamp

Adverse media flags

AttributeTypeDescription
risks[].namestringThe name of the associated risk category. The full possible list is included below.
risks[].confidence_levelstringThe values of this string can be high, moderate, or low.
sentiments[].namestringThe sentiment of the article. The value can be positive, neutral or negative.
sentiments[].confidence_levelstringThe confidence level of the corresponding sentiment.

Exclusion settings

AttributeTypeDescription
criteria_match_thresholdfloatThe minimum match score threshold for screening criteria.
max_people_screenedintegerThe maximum number of people to screen.
max_names_screenedintegerThe maximum number of names to screen.
peopleobject[]List of people included in the screening exclusion settings.

Possible risk categories

Risk Category
auctions
casinos
cryptocurrency
currency_exchanges_forex
cybercrime
fine_art
foreign_assets
human_trafficking
fraud_bribery_corruption
insider_trading
lending_services
luxury_vehicles
money_laundering
money_service_businesses
narcotics
non_profit
organized_crime
other_non_financial
terrorism
rare_gems_and_metals
real_estate
recreational_drugs
sanctions
sex_industry
smuggling_contraband
tax_evasion
terror_funding
used_merchandise
weapons_sales_trade
Get a demo
Contact your account manager or contact sales to inquire about access.