jolvAPI
jolv.app Open Jolv
API reference / Cap table & instruments

Audit log (instruments and holdings)

Returns a summary of the audit log of a company's or a fund's instruments, positions and holding lines: table, record, action, changed fields, date. Without before/after states nor actor by UUID. `updated_since` keeps only entries since that date. Read-only.

GET/v1/get_holdings_audit_log

Query parameters

  • company_iduuidoptional
    Company UUID (optional when fund_id is given).
  • fund_iduuidoptional
    Fund UUID (optional; holding lines of that fund).
  • updated_sincestringoptional
    Only return items created or modified since this date (YYYY-MM-DD or ISO 8601 timestamp, optional).
  • limitintegeroptional
    Maximum number of entries (default 100).

Response

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

  • entriesobject[]
    Show child attributes
    • entry_idstring
    • sourceenum
      Audited table.
      One of: instrument, fund_position, fund_holding
    • record_idstring
      Record concerned (instrument, position or holding line).
    • actionstring
      INSERT | UPDATE | DELETE
    • company_idstring · nullable
    • fund_idstring · nullable
    • campaign_idstring · nullable
    • changed_fieldsstring[]
      Changed fields (UPDATE); empty otherwise.
    • actor_labelstring · nullable
      Actor label as recorded (holding lines), never a UUID.
    • created_atstring

Errors

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