> ## Documentation Index
> Fetch the complete documentation index at: https://docs.docyard.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# List Audit Logs

> Query audit logs

# List Audit Logs

Query audit logs for all activities in the lake.

## Endpoint

```
GET /audit/logs
```

## Query Parameters

| Parameter       | Type     | Required | Description                                               |
| --------------- | -------- | -------- | --------------------------------------------------------- |
| `event`         | string   | No       | Filter by event type                                      |
| `actor_type`    | string   | No       | Filter by actor type: `distributor`, `collector`, `admin` |
| `actor_id`      | string   | No       | Filter by specific actor                                  |
| `resource_type` | string   | No       | Filter by resource type                                   |
| `after`         | datetime | No       | Events after timestamp                                    |
| `before`        | datetime | No       | Events before timestamp                                   |
| `page`          | integer  | No       | Page number (default: 1)                                  |
| `limit`         | integer  | No       | Items per page (default: 50, max: 100)                    |

## Request

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

## Response

```json theme={null}
{
  "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
  }
}
```

***

## Related Endpoints

* [Get Entity Logs](/api-reference/audit/entity-logs)