This model is part of an upcoming API update which is currently in beta and therefore subject to change.
GET https://ed.link/api/v2/audit/events/:scope_id/:scope_type
Retrieve a reverse-chronological list of recorded Events within a specified scope.
You must provide your application secret key in order to access this endpoint. This authentication mechanism is a little bit different than most other requests in our API because it is not made in the "scope" of one particular integration or person. You can find your application secret on the Edlink dashboard.
Request Parameters
This query allows for paging through results via the $next parameter.
You may narrow the results with the following optional query parameters:
| Parameter | Type | Description |
|---|---|---|
action | string | Only return Events with this action identifier, e.g. assignment.submit. |
actor.value | string | Only return Events where any Identifier in actor.identifiers has a matching value. |
actor.issuer | string | Only return Events where any Identifier in actor.identifiers has a matching issuer (e.g. edlink). |
actor.type | string | Only return Events whose actor.type matches. One of person, system, or external. |
target.value | string | Only return Events that include a target whose Identifier array contains a matching value. |
target.issuer | string | Only return Events that include a target whose Identifier array contains a matching issuer. |
target.type | string | Only return Events that include a target with this type. |
context.user_agent | string | Only return Events whose context object has a matching user_agent. |
context.http_method | string | Only return Events whose context object has a matching http_method. |
context.http_status | string | Only return Events whose context object has a matching http_status. |
context.path | string | Only return Events whose context object has a matching path. |
context.ip | string | Only return Events whose context object has a matching ip. |
context.query | string | Only return Events whose context object has a matching query. |
data | string | Only return Events which contain a fuzzy string match within their data object for the supplied data value. |
Sample Request
axios.get('https://ed.link/api/v2/audit/events/00000000-0000-0000-0000-000000000000/integration', {
headers: {
authorization: `Bearer ${application_secret_key}`
},
params: {
action: 'assignment.submit',
'actor.value': '00000000-0000-0000-0000-000000000000',
'actor.issuer': 'edlink'
}
});
Sample Response
{
"$request": "00000000-0000-0000-0000-000000000000",
"$data": [
{
"id": "00000000-0000-0000-0000-000000000000",
"created_date": "2026-06-02T18:00:24.573Z",
"actor": {
"identifiers": [
{ "value": "00000000-0000-0000-0000-000000000000", "issuer": "edlink" },
{ "value": "acme_user_42", "issuer": "acme" }
],
"type": "person",
"details": {...}
},
"action": "assignment.submit",
"action_type": "create",
"targets": [
{ "identifiers": [{ "value": "123", "issuer": "acme" }], "type": "assignment" },
{ "identifiers": [{ "value": "ABC", "issuer": "acme" }], "type": "class" }
],
"scope": {
"id": "00000000-0000-0000-0000-000000000000",
"type": "integration"
},
"context": {
"user_agent": "Chrome/123"
},
"data": {}
}
]
}