Skip to main content
GET
/
v1
/
audit
Query Audit Events
curl --request GET \
  --url https://api.truthlocks.com/v1/audit \
  --header 'X-API-Key: <api-key>'
{
  "items": [
    {
      "id": "evt_abc123",
      "tenant_id": "440e8400-e29b-41d4-a716-446655440000",
      "actor_id": "user-uuid",
      "actor_type": "USER",
      "action": "attestation.mint",
      "resource_type": "attestation",
      "resource_id": "660e8400-e29b-41d4-a716-446655440001",
      "metadata": {
        "issuer_id": "550e8400-e29b-41d4-a716-446655440000",
        "claim": "email_verified"
      },
      "timestamp": "2026-01-13T12:00:00Z"
    }
  ],
  "next_cursor": "eyJsYXN0X2lkIjoiZXZ0X2FiYzEyMyJ9"
}
Returns audit events for the authenticated tenant. Filter by actor, action, resource type, or time range.

​
Parameters

​
actor_id
string
Filter by user or API key ID
​
action
string
Filter by action (e.g., attestation.mint)
​
resource_type
string
Filter by resource type (attestation, issuer, user)
​
from
datetime
Start of time range (ISO 8601)
​
to
datetime
End of time range (ISO 8601)
​
limit
integer
Max events to return (default 50)

​
Responses

{
  "items": [
    {
      "id": "evt_abc123",
      "tenant_id": "440e8400-e29b-41d4-a716-446655440000",
      "actor_id": "user-uuid",
      "actor_type": "USER",
      "action": "attestation.mint",
      "resource_type": "attestation",
      "resource_id": "660e8400-e29b-41d4-a716-446655440001",
      "metadata": {
        "issuer_id": "550e8400-e29b-41d4-a716-446655440000",
        "claim": "email_verified"
      },
      "timestamp": "2026-01-13T12:00:00Z"
    }
  ],
  "next_cursor": "eyJsYXN0X2lkIjoiZXZ0X2FiYzEyMyJ9"
}

Authorizations

​
X-API-Key
string
header
required

API key for machine-to-machine authentication

Query Parameters

​
actor_id
string
​
action
string
​
resource_type
string
​
from
string<date-time>
​
to
string<date-time>
​
limit
integer
default:50

Response

200 - application/json

Audit events

​
items
object[]
​
next_cursor
string