APIs & Services
Profile API
16 min
the profile api allows provides powerful search capabilities across our extensive dataset to retrieve detailed information about individuals and organizations users can search using key criteria such as names, organizations , or unique identifiers like person id or organization id to access rich profiles and data available data points for details on the available data points that can be used within your queries please navigate to the documentation section within graphiql here you will find a list of the available data points, their definitions and data types you can find the url for graphiql on our docid 3rgzmf5uh3ep0bh4snvm0 section we have supplied example graphql queries that you can copy and paste into your graphql query builder can't find the field you're looking for? remember that you can customise each of the provided example queries to return the information that matters to you example queries person keyword search find one or more people using a search keyword the searchkeyword operates over the firstname , lastname and organizationname a combination of firstname , lastname and organizationname can be used to further refine search results query myquery { personkeywordsearch(filter {searchkeyword "david mcdonald"}) { on personpagedresult { typename items { firstname lastname rolesboard { items { organization { organizationname } startdate { displaydate } enddate { displaydate } } } rolesemployment { items { organization { organizationname organizationtype } } } education { items { person { name } organization { organizationname organizationtype } startdate { displaydate } enddate { displaydate } qualification qualificationcategory } } } } on genericerror { typename errorcode errormessage } on validationerror { typename errorcode errormessage } } } person id search search for a specific individual using their altrata id query myquery { personidsearch(id "1 per 4518022") { on person { name gender } on genericerror { typename errorcode errormessage } on validationerror { typename errorcode errormessage } } } person bulk id search search for up to 100 people using their altrata ids query myquery { personbulkidsearch(filter {ids \["1 per 41000090", "1 per 4518022"]}) { on personpagedresult { typename items { firstname rolesemployment { items { title } } } } on genericerror { typename errorcode errormessage } on validationerror { typename errorcode errormessage } } } organization keyword search find one or more organizations using a search keyword the searchkeyword operates over the organizationname query myquery { organizationkeywordsearch(filter {searchkeyword "microsoft"}) { on organizationpagedresult { typename items { organizationname organizationtype website latestdailymarketcapital latestannualmarketrevenue headofficeaddress { address city country } rolesboard { items { person { name } type title } } rolesemployment { items { person { name } type title } } } } on genericerror { typename errorcode errormessage } on validationerror { typename errorcode errormessage } } } organization id search search for a specific organization using their altrata id query myquery { organizationidsearch(id "1 org 3303587") { on organization { organizationname id organizationtype tickerprimary industryprimary sectorprimary headofficeaddress { address zip state city country } website datefounded { displaydate } latestdailymarketcapital latestannualmarketrevenue } on genericerror { typename errorcode errormessage } on validationerror { typename errorcode errormessage } } } organization bulk id search search for up to 100 organizations using their altrata ids query myquery { organizationbulkidsearch(filter {ids \["1 org 3303587", "1 org 426502756"]}) { on organizationpagedresult { typename items { organizationname id organizationtype tickerprimary industryprimary } } on genericerror { typename errorcode errormessage } on validationerror { typename errorcode errormessage } } } person search facilitates searching for individuals based on various attributes such as name, employment history, role details, and professional status users can input multiple filters to find the individuals relevent to their use case full details of the person search filter inputs can be found here docid\ itsm4zqc3qx8l9ynioi9s sample request query myquery { personsearch( filter {age {gte 35, lte 65}, gender {searchvalues "female"}, roletitlecategory {searchvalues "ceo"}} ) { on personsearchpagedresult { typename items { name age gender roletitle rolestatus organizationname } } } } sample response { "data" { "personsearch" { " typename" "personsearchpagedresult", "items" \[ { "name" "kristi longdes", "age" 58, "gender" "female", "roletitle" "chief executive officer", "rolestatus" "prior", "organizationname" "ji org se" }, { "name" "frances kalto", "age" 60, "gender" "female", "roletitle" "joint chief executive officer", "rolestatus" "current", "organizationname" "corestandard plc" } organization search enables users to find organizations based on specific parameters such as company size, industry, revenue, and market capitalization sample request query myquery { organizationsearch( filter {country {searchvalues "united states"}, industryprimary {searchvalues "accounting & financial services"}, marketcap {gte 10000000, lte 1000000000}} ) { on organizationpagedresult { typename items { organizationname headofficeaddress { country state } latestdailymarketcapital industryprimary } } } } sample response { "data" { "organizationsearch" { " typename" "organizationpagedresult", "items" \[ { "organizationname" "polurt ab holdings, inc ", "headofficeaddress" { "country" "united states", "state" "texas" }, "latestdailymarketcapital" 76064400, "industryprimary" "accounting & financial services" }, { "organizationname" "mango financial corp ", "headofficeaddress" { "country" "united states", "state" "new york" }, "latestdailymarketcapital" 891081900, "industryprimary" "accounting & financial services" } charitable donations facilitate searching for charitable donation history of an individual the query operates over the personid , recipientorganizationid and donororganiationid users can further refine the query by inputting optional charitable causes and donation measurement dates sample request query myquery { charitabledonations(filter {personid "1 per 41854138"}) { on charitabledonationpagedresult { typename items { amount donorpeople { name age gender } recipientorganization { organizationname charitablecauses { causeprimary } } } } } } sample response "data" { "charitabledonations" { " typename" "charitabledonationpagedresult", "items" \[ { "amount" 63000, "donorpeople" \[ { "name" "john coadlep", "age" 52, "gender" "male" } ], "recipientorganization" { "organizationname" "foundation name", "charitablecauses" { "causeprimary" "private independent foundations" } } }, political donations facilitates the search for political donations of a client using donorpersonid , recepientpersonid and recepientorganizationid or recepientpoliticalpartyorganizationid queries can further be refined by including optional donation measurement dates query politicaldonations recipientpoliticalorganizationid { politicaldonations( filter {recipientpoliticalpartyorganizationid "1 org 133981810", donorpersonid "1 per 101331726"} pageinfo {} ) { on politicaldonationpagedresult { items { id amount donorpeople { name id } recipientperson { id name } recipientpoliticalpartyorganization { id organizationname organizationtype politicalparty } recipientorganization { id organizationname organizationtype } } pageinforesponse { totalcount } } } } sample response { "data" { "politicaldonations" { "items" \[ { "id" "1 pdc 111111111", "amount" 500, "donorpeople" \[ { "name" "sara chaplin", "id" "1 per 789744" } ], "recipientperson" { "id" "1 per 456771", "name" "janis westerfield" }, "recipientpoliticalpartyorganization" { "id" "1 org 259632", "organizationname" "democratic party", "organizationtype" "private", "politicalparty" "democratic" } } wealth asset sample request facilitate the search for an individual's wealth portfolio by entering the person's profile id , which further allows filtering on following components private holdings , common stocks , stock options , cash , other assets , and alternative investments query wealthasset personid { wealthassets( filter {personid "1 per 41000090", assetclassification private holding} pageinfo {} ) { on wealthassetpagedresult { typename items { owner { name id gender } ownershippercentage ownershipvalue purchasedate { displaydate } relatedorganization { organizationname organizationtype } } } } } sample response { "data" { "wealthassets" { " typename" "wealthassetpagedresult", "items" \[ { "owner" \[ { "name" "full name of the owner", "id" "1 per profile id of the owner", "gender" "male" } ], "ownershippercentage" 42, "ownershipvalue" 2890000, "purchasedate" { "displaydate" 2024 01 01 }, "relatedorganization" { "organizationname" "denzo ip", "organizationtype" "private" }



