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
  • Politically exposed person screening object
  • Politically exposed person results
Middesk APIBusiness VerificationObject reference

Politically exposed persons screening object

Was this page helpful?
Previous

Registration object

Next
Built with

This page describes the results Middesk returns after running people through a Politically Exposed Persons (PEP) screening. Results contain information about the people close to the officers or related to the Business who qualify as a politically exposed person.

Politically exposed person screening object

PropertyTypeDescriptionGuaranteed
objectstringThe object type. Always politically_exposed_person_screening.Yes
idstring (uuid)Middesk generated unique identifier for the PEP Screening objectYes
created_attimestampYes
updated_attimestampYes
resultsobject[]An array of politically exposed person resultsMay be []
settingsobjectConfiguration settings for the PEP screening.No
settings.peoplestringThe people configuration for screening.No
settings.match_scorestringThe match score threshold. Possible values: LOW, MEDIUM, HIGH.No

Politically exposed person results

PropertyTypeDescriptionGuaranteed
objectstringThe object type. Always politically_exposed_person_screening_result.Yes
idstring (uuid)Middesk-generated unique identifier for the PEP result object.Yes
aliasesstring[]Other names for the politically exposed person.May be []
birth_namestringThe name that the PEP was born with.May be null
birth_placestringThe place where the PEP was born.May be null
citizenship_countrystringThe country that the PEP has citizenship in.May be null
dobdateThe date of birth of the PEP.May be null.
employersstring[]The employment history of the PEP.May be []
hit_typestringIf the PEP is a direct, direct_alias or association hit. Association hits are PEP that an officer of the Business is associated with. One of direct_alias, association, direct.
membershipsobject[]Clubs, associations, and parties that the PEP is involved with.May be []
namestringName of the PEP.May be null
professional_historystring[]Current and past employers of the PEP.May be []
scorefloatIndicates the confidence in the match between the officer and the found PEP result.Yes
source_urlsstring[]Sources where more details can be found about the PEP.May be []
stakeholdersobject[]Associated stakeholders related to the PEP.May be []
Get a demo
Contact your account manager or contact sales to inquire about access.