Deal sheet · API reference

Query parameters

company_iduuidrequired
Company / opportunity UUID.

Response

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

company_idstring
namestring · nullable
stagestring · nullable
sectorstring · nullable
ticket_demande_eurnumber · nullable
valo_demandee_eurnumber · nullable
briefobject · nullable
Show child attributes
- resumestring · nullable
- points_fortsstring · nullable
- points_vigilancestring · nullable
- prochaines_etapesstring · nullable
next_stepsobject[]
Show child attributes
- labelstring
- due_datestring · nullable

Errors

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

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

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

{ "company_id": "e3f4a5b6-c7d8-4e9f-a0b1-c2d3e4f5a6b7", "name": "Helio Robotics", "stage": "due_diligence", "sector": "Industrials", "ticket_demande_eur": 4000000, "valo_demandee_eur": 18000000, "brief": { "resume": "Industrial robotics integrator, EUR 9m revenue, 40 % recurring maintenance contracts.", "points_forts": "Sticky customer base, 28 % EBITDA margin, founder-led with succession plan.", "points_vigilance": "Customer concentration (top 3 = 55 % of revenue), capex cycle exposure.", "prochaines_etapes": "Financial DD report expected 2026-03-20; management meeting 2026-03-27." }, "next_steps": [ { "label": "Financial due diligence report", "due_date": "2026-03-20" }, { "label": "Management meeting", "due_date": "2026-03-27" } ] }