For Developers

List Events

GET https://ed.link/api/v2/graph/events

Retrieve a list of all available Events.

Events go back in time up to 30 days, in accordance with our data retention policy. Events should always be processed in the order in which they are returned. When paging through events, it is always recommended to page forward using $first and $after.

While backward paging is supported, there is really no good reason to do so, and it may result in corrupted data (due to events being applied in reverse order).

Request Parameters

This query allows for standard paging parameters.

Sample Request

// List the 5 most recent events.
axios.get('https://ed.link/api/v2/graph/events?$last=5', {
    headers: {
        authorization: `Bearer ${integration_access_token}`
    }
});

Sample Response

{
  "$data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "date": "2021-07-26T06:15:47.179Z",
      "type": "deleted",
      "target": "person",
      "target_id": "00000000-0000-0000-0000-000000000000",
      "integration_id": "00000000-0000-0000-0000-000000000000",
      "materialization_id": "00000000-0000-0000-0000-000000000000",
      "data": {
        ...
      }
    }
  ],
  "$request": "00000000-0000-0000-0000-000000000000"
}