List Audit Events
GET
https://api-prod.useknit.io/api/v1/managed-signing/audit
This endpoint retrieves audit events for signing requests. Audit events are fetched from Knit Core but mapped by local request ID.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
requestId | string | No | Filter by local request ID |
Request
curl "https://api-prod.useknit.io/api/v1/managed-signing/audit?requestId=<local-request-id>" \
-H "Authorization: Bearer $KNIT_ACCESS_TOKEN" \
-H "Accept: application/json"Response
Response
{
"statusCode": 200,
"message": "Audit events retrieved",
"data": [
{
"id": "<audit-event-id>",
"requestId": "<local-request-id>",
"action": "SIGNING_REQUEST_CREATED",
"actor": "api_key",
"timestamp": "2026-01-20T18:30:40.912Z",
"metadata": {
"walletId": "<local-wallet-id>",
"network": "MATIC_MAINNET",
"type": "evm_tx"
}
},
{
"id": "<audit-event-id>",
"requestId": "<local-request-id>",
"action": "SIGNING_REQUEST_APPROVED",
"actor": "api_key",
"timestamp": "2026-01-20T18:35:22.456Z",
"metadata": {
"walletId": "<local-wallet-id>",
"status": "SIGNED"
}
}
],
"success": true
}Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Audit event ID |
requestId | string | Local request ID |
action | string | Action performed |
actor | string | Who performed the action |
timestamp | string | When the action occurred |
metadata | object | Additional event metadata |
Audit Actions
| Action | Description |
|---|---|
SIGNING_REQUEST_CREATED | A signing request was created |
SIGNING_REQUEST_APPROVED | A signing request was approved |
SIGNING_REQUEST_DENIED | A signing request was denied by policy |
SIGNING_REQUEST_FAILED | A signing request failed |
Notes
- Audit events provide a complete history of actions taken on signing requests.
- Use the
requestIdquery parameter to filter events for a specific signing request. - All request IDs in audit events are local IDs, not Knit Core IDs.
