Company financials · API reference

Query parameters

company_iduuidrequired
Company UUID.
campaign_iduuidoptional
Campaign UUID (optional; reads campaign_company_financials).

Response

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

currencystring · nullable
yearsobject[]
Show child attributes
- yearnumber · nullable
- canumber · nullable
  Revenue (€m)
- ebitdanumber · nullable
  EBITDA (€m)
- ebitnumber · nullable
  EBIT (€m)
- resultat_netnumber · nullable
- dfnnumber · nullable
  Net financial debt (€m)
- effectifsnumber · 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_company_financials?company_id=<company_id>" \
  -H "Authorization: Bearer $JOLV_TOKEN"

Python

import os, requests

r = requests.get(
    "https://jolv-mcp.vercel.app/v1/get_company_financials",
    params={"company_id": "<company_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_company_financials" + "?" + new URLSearchParams({ company_id: "<company_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_company_financials",
        [Query = [company_id = "<company_id>"], Headers = [Authorization = "Bearer <access_token>"]]))
in
    Source

Example response (illustrative values)

200

{
  "currency": "EUR",
  "years": [
    {
      "year": 2024,
      "ca": 21.4,
      "ebitda": 4.1,
      "ebit": 3.2,
      "resultat_net": 2.1,
      "dfn": 5.6,
      "effectifs": 142
    },
    {
      "year": 2025,
      "ca": 24,
      "ebitda": 4.8,
      "ebit": 3.9,
      "resultat_net": 2.6,
      "dfn": 4.8,
      "effectifs": 158
    },
    {
      "year": 2026,
      "ca": 26.9,
      "ebitda": 5.5,
      "ebit": 4.5,
      "resultat_net": 3,
      "dfn": 3.9,
      "effectifs": 171
    }
  ]
}

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.