Get a provenance row

GET

https://api.aventure.vc/v1/provenance/:provenanceId

GET

/v1/provenance/:provenanceId

$ curl https://api.aventure.vc/v1/provenance/42 \
>      -H "Authorization: Bearer <token>"

1 {
2   "changes": [
3     {
4       "fieldName": "string",
5       "newPresent": true,
6       "oldPresent": true,
7       "newValue": "string",
8       "oldValue": "string"
9     }
10   ],
11   "effectiveAt": "2024-01-15T09:30:00Z",
12   "eventId": "string",
13   "id": 1,
14   "operation": "insert",
15   "recordId": "string",
16   "source": {
17     "sourceDetail": "aventure.vc",
18     "sourceType": "aventureStaff",
19     "actorType": "agent",
20     "agentChassis": "codex-cli",
21     "agentModel": "string",
22     "sourceProvider": "TechCrunch",
23     "sourceProviderId": "tc-2026-05-20-example-round",
24     "sourceProviderSlug": "example-round"
25   },
26   "status": "unconfirmed",
27   "tableName": "entity",
28   "actor": {
29     "displayName": "string",
30     "type": "agent",
31     "agent": {
32       "chassis": "claude-code",
33       "model": "string",
34       "modelFamily": "claude"
35     },
36     "employeeDisplayName": "string",
37     "employeeUserId": "string"
38   },
39   "changedBy": "string",
40   "entityId": "string",
41   "personId": "string"
42 }

Returns one field-level provenance row by its surrogate id, in the same shape the provenance history list returns.

Authentication

AuthorizationBearer

User bearer token: Supabase or Clerk session JWT, Clerk OAuth access token, or Clerk personal API key

X-API-Keystring

Admin API key for system-to-system write operations

X-Client-Secretstring

Client secret for read-only service-to-service access (no writes)

Path parameters

provenanceIdlongRequired

Provenance row surrogate id

Response

changeslist of objects

effectiveAtdatetime

eventIdstringformat: "uuid"

idlong

operationenum

Write operation captured by a provenance event row

recordIdstring

sourceobject

Write provenance supplied on mutation query parameters.

statusenum

Confidence and dispute state of a field-level provenance row

tableNameenum

Domain resource whose field-level provenance is tracked

actorobject or nullOptional

Authenticated actor that authored a provenance write event

changedBystring or nullOptional

entityIdstring or nullOptionalformat: "uuid"

personIdstring or nullOptionalformat: "uuid"

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

406

Not Acceptable Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error