Get identity audit log

Returns the combined audit log for an identity and all of its verification sessions, sorted by event time (newest first). Each entry records the actor, action, and any metadata captured when the event occurred.

Authentication

X-API-Keystring

Organization API key. Keys are prefixed with vk_live_ (production) or vk_sandbox_ (sandbox).

Path parameters

identity_idstringRequired

Identity ID (idn_*) or external reference.

Query parameters

limitintegerOptional1-100Defaults to 50

Maximum number of events to return.

offsetintegerOptional>=0Defaults to 0

Number of events to skip.

Response

Identity audit log.

datalist of objects

paginationobject

Errors

401

Unauthorized Error

404

Not Found Error

1	{
2	"data": [
3	{
4	"id": "audit_9f8b7c6d5e4a3b2c1d0e",
5	"type": "dashboard.identity.tag_added",
6	"resource_type": "identity",
7	"resource_id": "idn_1234567890abcdef",
8	"created_at": "2024-01-15T09:30:00Z",
9	"actor": "admin@verifa.com",
10	"metadata": {
11	"tag": "high-risk",
12	"reason": "Manual review flagged"
13	}
14	}
15	],
16	"pagination": {
17	"total": 1,
18	"limit": 1,
19	"offset": 0
20	}
21	}

1	{
2	"data": [
3	{
4	"id": "audit_9f8b7c6d5e4a3b2c1d0e",
5	"type": "dashboard.identity.tag_added",
6	"resource_type": "identity",
7	"resource_id": "idn_1234567890abcdef",
8	"created_at": "2024-01-15T09:30:00Z",
9	"actor": "admin@verifa.com",
10	"metadata": {
11	"tag": "high-risk",
12	"reason": "Manual review flagged"
13	}
14	}
15	],
16	"pagination": {
17	"total": 1,
18	"limit": 1,
19	"offset": 0
20	}
21	}

Get identity audit log

Authentication

Path parameters

Headers

Query parameters

Response

Errors

Authentication

Path parameters

Headers

Query parameters

Response

Errors

$	curl https://devapi.withverifa.com/api/v1/identities/identity_id/audit-log \
>	-H "X-API-Key: <apiKey>" \
>	-H "Content-Type: application/json"