Audit thread · API reference

Query parameters

entity_iduuidrequired
Valuation UUID (campaign_valuation).

Response

Status 200, application/json. Resources outside your rights are absent, never an error.

entity_idstring
eventsobject[]
Show child attributes
- atstring
- event_typestring
- actorstring · nullable
- detailstring · nullable

Errors

400 invalid parameter · 401 missing or expired token · 429 too many requests · 500 read failed. See Errors.

Request

cURL

curl "https://jolv-mcp.vercel.app/v1/get_audit_thread?entity_id=<entity_id>" \
  -H "Authorization: Bearer $JOLV_TOKEN"

Python

import os, requests

r = requests.get(
    "https://jolv-mcp.vercel.app/v1/get_audit_thread",
    params={"entity_id": "<entity_id>"},
    headers={"Authorization": f"Bearer {os.environ['JOLV_TOKEN']}"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

JavaScript

const r = await fetch("https://jolv-mcp.vercel.app/v1/get_audit_thread" + "?" + new URLSearchParams({ entity_id: "<entity_id>" }), {
  headers: { Authorization: `Bearer ${process.env.JOLV_TOKEN}` },
});
if (!r.ok) throw new Error((await r.json()).error.message);
const data = await r.json();

Power Query

let
    Source = Json.Document(Web.Contents(
        "https://jolv-mcp.vercel.app/v1/get_audit_thread",
        [Query = [entity_id = "<entity_id>"], Headers = [Authorization = "Bearer <access_token>"]]))
in
    Source

Example response (illustrative values)

200

{
  "entity_id": "e4f5a6b7-c8d9-4e0f-a1b2-c3d4e5f6a7b8",
  "events": [
    {
      "at": "2026-01-20T09:12:04Z",
      "event_type": "created",
      "actor": "analyst",
      "detail": "Valuation sheet created for Q4 2025"
    },
    {
      "at": "2026-02-03T14:40:51Z",
      "event_type": "method_changed",
      "actor": "analyst",
      "detail": "Method set to multiples (EBITDA × 9.5x)"
    },
    {
      "at": "2026-02-10T11:02:17Z",
      "event_type": "submitted",
      "actor": "analyst",
      "detail": "Submitted for approval"
    },
    {
      "at": "2026-02-14T16:05:22Z",
      "event_type": "finalized",
      "actor": "validator",
      "detail": "Approved and sealed"
    }
  ]
}

Try it

or paste a token below

The call goes from your browser to the API with your own token; nothing is stored. Token kept in this tab only.