---
title: Events API
slug: events-api
createdAt: 2025-05-16T12:00:14.017Z
---

**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](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.

```graphql
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.

```graphql
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**

```graphql
{
    "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
                }
            }
        }
    }
```