Get an audit event by ID

Use this endpoint to retrieve a single audit event by its unique identifier. Designed for SOX/GLBA compliance.

GET /v1/audit-events/{id}

Get an audit event by ID

cURL

curl --request GET \
  --url https://tracer.sandbox.lerian.net/v1/audit-events/{id} \
  --header 'Authorization: Bearer <token>'

200

{
  "action": "VALIDATE",
  "actor": {
    "actorType": "user",
    "id": "00000000-0000-0000-0000-000000000000",
    "ipAddress": "203.0.113.42",
    "name": "Jane Doe",
    "role": "admin"
  },
  "createdAt": "2021-01-01T00:00:00Z",
  "eventId": "00000000-0000-0000-0000-000000000000",
  "eventType": "TRANSACTION_VALIDATED",
  "resourceId": "00000000-0000-0000-0000-000000000000",
  "resourceType": "transaction",
  "result": "ALLOW",
  "context": {},
  "hash": "a3f1e2b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2",
  "metadata": {},
  "previousHash": "b4e2f3a5c6d7e8f9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3"
}

Authorizations

BearerAuthApiKeyAuth

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Path Parameters

id · string · required

Audit event ID (UUID)

Response

200

application/json

OK

action · string · required

Example:

"VALIDATE"

actor · object · required

Show child attributes

createdAt · string<date-time> · required

Example:

"2021-01-01T00:00:00Z"

eventId · string<uuid> · required

Example:

"00000000-0000-0000-0000-000000000000"

eventType · string · required

Example:

"TRANSACTION_VALIDATED"

resourceId · string · required

Example:

"00000000-0000-0000-0000-000000000000"

resourceType · string · required

Example:

"transaction"

result · string · required

Example:

"ALLOW"

context · object

Show child attributes

hash · string

Example:

"a3f1e2b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2"

metadata · object

Show child attributes

previousHash · string

Example:

"b4e2f3a5c6d7e8f9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3"