APIs & Services
Events API
4 min
the events api provides structured access to key leadership and organizational events, with a focus on executive role announcements it allows you to query events associated with a specific person or organization , filtered by event type groups (e g , role changes), and includes other relevant individuals or organizations mentioned in each announcement using a unique altrataid, you can retrieve both current and upcoming leadership announcements events are sorted by effective date , displayed from newest to oldest, enabling teams to monitor important personnel movements as they unfold the api returns comprehensive information, including for events announcementdateinfo, endroletitle, eventdateinfo, eventid, eventpublisheddate, eventtext, organizationmentions, personmentions, startroletitle available data points for details on the available data points that can be used within your queries please navigate to the docid 3rgzmf5uh3ep0bh4snvm0 section here you will find a list of the available data points, their definitions and data types example queries we have supplied example graphql queries that you can copy and paste into your graphql query builder return events for person/organization query retrieves all future announcements for a particular user (person's profile) including other people/organizations that were mentioned query { events( altrataid "1 per 11111111", filtertype announcements, sorttype event date, ) { typename on eventsresponse { events { typename announcementdateinfo { date dateprecision displaydate } endroletitle eventdateinfo { date dateprecision displaydate } eventid eventpublisheddate eventtext organizationmentions { organizationid organizationname organizationtype } personmentions { personid personname } startroletitle } pageinforesponse { pageinfo { hasnextpage endcursor } } } on error { correlationid errormessage } on genericerror { correlationid errormessage genericerrorcode } on validationerror { correlationid errormessage validationerrorcode validationerrordetails { code message path } } } } future announcements this query retrieves all future announcements for a particular organization (organization's profile) including other people/organizations that were mentioned query { events( altrataid "1 org 154701", filtertype announcements, sorttype event date, ) { typename on eventsresponse { events { typename announcementdateinfo endroletitle eventdateinfo eventid eventpublisheddate eventtext organizationmentions { organizationid organizationname organizationtype } personmentions { personid personname } startroletitle } pageinforesponse { totalcount lastpagenumber pageinfo { hasnextpage endcursor } } } on error { correlationid errormessage } on genericerror { correlationid errormessage genericerrorcode } on validationerror { correlationid errormessage validationerrorcode validationerrordetails { code message path } } } } sample response { "data" { "events" { " typename" "eventsresponse", "events" \[ { " typename" "event", "announcementdateinfo" { date "2025 03 11", dateprecision "day" displaydate "2025 03 11", }, "endroletitle" "ceo", "eventdateinfo" { date "2026 01 01", dateprecision "year" displaydate "2026", }, "eventid" "1 evt 33333", "eventpublisheddate" "2025 03 13", "eventtext" "kent wood will leave his role as ceo at microsoft corp on 31st december 3026", "organizationmentions" \[ { "organizationid" "1 org 1111111", "organizationname" "microsoft corporation", "organizationtype" "public" } ], "personmentions" \[ { "personid" "1 per 11111111", "personname" "kent wood" } ], "startroletitle" null }, { " typename" "event", "announcementdateinfo" { date "2025 03 11", dateprecision "day" displaydate "2025 03 11", }, "endroletitle" "ceo", "eventdateinfo" { date "2026 01 01", dateprecision "year" displaydate "2026", }, "eventid" "1 evt 3333", "eventpublisheddate" "2025 03 12", "eventtext" "kent wood will leave his role as ceo at microsoft corp on 31st december 3026", "organizationmentions" \[ { "organizationid" "1 org 1111111", "organizationname" "microsoft corporation", "organizationtype" "public" } ], "personmentions" \[ { "personid" "1 per 1111111", "personname" "kent wood" } ], "startroletitle" null }, { " typename" "event", "announcementdateinfo" { date "2025 03 11", dateprecision "day" displaydate "2025 03 11", }, "endroletitle" "ceo", "eventdateinfo" { date "2026 01 01", dateprecision "year" displaydate "2026", }, "eventid" "1 evt 22222", "eventpublisheddate" "2025 03 13", "eventtext" "it has been announced that kent wood will change roles from cto to ceo at microsoft corp on 1st may 3026", "organizationmentions" \[ { "organizationid" "1 org 11111", "organizationname" "microsoft corporation", "organizationtype" "public" } ], "personmentions" \[ { "personid" "1 per 111111", "personname" "kent wood" } ], "startroletitle" "ceo" }, { " typename" "event", "announcementdateinfo" { date "2025 03 11", dateprecision "day" displaydate "2025 03 11", }, "endroletitle" "ceo", "eventdateinfo" { date "2026 01 01", dateprecision "year" displaydate "2026", }, "eventid" "1 evt 3333", "eventpublisheddate" "2025 03 12", "eventtext" "it has been announced that kent wood will change roles from cto to ceo at microsoft corp on 1st may 3026", "organizationmentions" \[ { "organizationid" "1 org 111111", "organizationname" "microsoft corporation", "organizationtype" "public" } ], "personmentions" \[ { "personid" "1 per 111111", "personname" "kent wood" } ], "startroletitle" "ceo" }, { " typename" "event", "announcementdateinfo" { date "2025 03 11", dateprecision "day" displaydate "2025 03 11", }, "endroletitle" "ceo", "eventdateinfo" { date "2026 01 01", dateprecision "year" displaydate "2026", }, "eventid" "1 evt 44444", "eventpublisheddate" "2025 03 13", "eventtext" "kent wood will join microsoft corporation as cto on 1st january 3026", "organizationmentions" \[ { "organizationid" "1 org 11111", "organizationname" "microsoft corporation", "organizationtype" "public" } ], "personmentions" \[ { "personid" "1 per 111111", "personname" "kent wood" } ], "startroletitle" "cto" }, { " typename" "event", "announcementdateinfo" { date "2025 03 11", dateprecision "day" displaydate "2025 03 11", }, "endroletitle" "ceo", "eventdateinfo" { date "2026 01 01", dateprecision "year" displaydate "2026", }, "eventid" "1 evt 55555", "eventpublisheddate" "2025 03 12", "eventtext" "kent wood will join microsoft corporation as cto on 1st january 3026", "organizationmentions" \[ { "organizationid" "1 org 111111", "organizationname" "microsoft corporation", "organizationtype" "public" } ], "personmentions" \[ { "personid" "1 per 111111", "personname" "kent wood" } ], "startroletitle" "cto" } ], "pageinforesponse" { "pageinfo" { "hasnextpage" false, "endcursor" null } } } }


