Events API
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 Data Dictionaries 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
}
}
}
}