Skip to main content

​
List Audit Logs

Query audit logs for all activities in the lake.

​
Endpoint

GET /audit/logs

​
Query Parameters

ParameterTypeRequiredDescription
eventstringNoFilter by event type
actor_typestringNoFilter by actor type: distributor, collector, admin
actor_idstringNoFilter by specific actor
resource_typestringNoFilter by resource type
afterdatetimeNoEvents after timestamp
beforedatetimeNoEvents before timestamp
pageintegerNoPage number (default: 1)
limitintegerNoItems per page (default: 50, max: 100)

​
Request

curl -X GET "https://api.docyard.io/v1/audit/logs?event=artifact_retrieved&limit=10" \
  -H "X-API-Key: dk_live_dist_aaaaaaaa"

​
Response

{
  "logs": [
    {
      "id": "log-abc123",
      "event": "artifact_retrieved",
      "timestamp": "2026-03-15T14:30:00Z",
      "actor": {
        "type": "collector",
        "id": "coll-xyz789",
        "name": "FirstCity Bank"
      },
      "resource": {
        "type": "artifact",
        "id": "art-abc123"
      },
      "details": {
        "dock_id": "dock-abc123",
        "keys_provided": ["policy_number"],
        "score": 20,
        "threshold": 20,
        "result": "granted"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 4521,
    "total_pages": 453
  }
}