List where a record's data came from

GET

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

GET

/v1/provenance

curl -G https://api.aventure.vc/v1/provenance \
     -H "Authorization: Bearer <token>" \
     -d tableName=entity

{
  "content": [
    {
      "changes": [
        {
          "fieldName": "string",
          "newPresent": true,
          "oldPresent": true,
          "newValue": "string",
          "oldValue": "string"
        }
      ],
      "effectiveAt": "2024-01-15T09:30:00Z",
      "eventId": "string",
      "id": 1,
      "operation": "insert",
      "recordId": "string",
      "source": {
        "sourceDetail": "aventure.vc",
        "sourceType": "aventureStaff",
        "actorType": "agent",
        "agentChassis": "codex-cli",
        "agentModel": "string",
        "sourceProvider": "TechCrunch",
        "sourceProviderId": "tc-2026-05-20-example-round",
        "sourceProviderSlug": "example-round"
      },
      "status": "unconfirmed",
      "tableName": "entity",
      "actor": {
        "displayName": "string",
        "type": "agent",
        "agent": {
          "chassis": "claude-code",
          "model": "string",
          "modelFamily": "claude"
        },
        "employeeDisplayName": "string",
        "employeeUserId": "string"
      },
      "changedBy": "string",
      "entityId": "string",
      "personId": "string"
    }
  ],
  "empty": true,
  "first": true,
  "last": true,
  "number": 1,
  "numberOfElements": 1,
  "pageable": {
    "offset": 1,
    "pageNumber": 1,
    "pageSize": 1,
    "paged": true,
    "sort": {
      "empty": true,
      "sorted": true,
      "unsorted": true
    },
    "unpaged": true
  },
  "size": 1,
  "sort": {
    "empty": true,
    "sorted": true,
    "unsorted": true
  },
  "totalElements": 1,
  "totalPages": 1
}

Returns paginated field-level provenance rows ordered by effectiveAt DESC. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.

Authentication

AuthorizationBearer

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

Query parameters

tableNameenumRequired

Tracked resource. Canonical form is the camelCase wire token (e.g. entity, newsArticle); the legacy Postgres table name (res_entity) is still accepted for backwards compatibility.

recordIdstringOptional

Record key of the tracked row (text)

pageintegerOptional>=0Defaults to 0

Zero-based page index (0..N)

sizeintegerOptional>=1Defaults to 25

The size of the page to be returned

Response headers

X-RateLimit-Limitinteger

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-Remaininginteger

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-Resetinteger

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

contentlist of objectsOptional

emptybooleanOptional

firstbooleanOptional

lastbooleanOptional

numberintegerOptional

numberOfElementsintegerOptional

pageableobjectOptional

sizeintegerOptional

sortobjectOptional

totalElementslongOptional

totalPagesintegerOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

406

Not Acceptable Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error