Financial alerts · API reference

Query parameters

company_iduuidoptional
Company UUID (optional; otherwise the whole organisation).
include_dismissedbooleanoptional
Include dismissed alerts (default false).
updated_sincestringoptional
Only return items created or modified since this date (YYYY-MM-DD or ISO 8601 timestamp, optional).

Response

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

alertsobject[]
Show child attributes
- severitystring · nullable
- titlestring · nullable
- messagestring · nullable
- risk_scorenumber · nullable
- dismissedboolean
- created_atstring · 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_financial_alerts" \
  -H "Authorization: Bearer $JOLV_TOKEN"

Python

import os, requests

r = requests.get(
    "https://jolv-mcp.vercel.app/v1/get_financial_alerts",
    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_financial_alerts", {
  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_financial_alerts",
        [Headers = [Authorization = "Bearer <access_token>"]]))
in
    Source

Example response (illustrative values)

200

{
  "alerts": [
    {
      "severity": "medium",
      "title": "Net debt above covenant threshold",
      "message": "Net debt / EBITDA reached 3.1x at 2025-12-31 against a 3.0x covenant.",
      "risk_score": 62,
      "dismissed": false,
      "created_at": "2026-02-02T08:15:00Z"
    },
    {
      "severity": "low",
      "title": "Revenue below budget",
      "message": "FY2025 revenue 3 % below budget (EUR 24.0m vs EUR 24.8m).",
      "risk_score": 28,
      "dismissed": true,
      "created_at": "2026-01-18T17:42:10Z"
    }
  ]
}

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.