Advisor firms · API reference

Query parameters

No parameters. The response is scoped by the rights of the authenticated user.

Response

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

firmsobject[]
Show child attributes
- advisor_firm_idstring
- namestring
- websitestring · nullable
- contactsnumber
  Number of contacts linked to the firm (see list_contacts).
- 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/list_advisor_firms" \
  -H "Authorization: Bearer $JOLV_TOKEN"

Python

import os, requests

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

Example response (illustrative values)

200

{
  "firms": [
    {
      "advisor_firm_id": "4e5f6a7b-8c9d-4e0f-9a1b-3c4d5e6f7a8b",
      "name": "Lumière Avocats",
      "website": "https://www.lumiere-avocats.example",
      "contacts": 3,
      "created_at": "2025-09-12T09:00:00Z"
    },
    {
      "advisor_firm_id": "5f6a7b8c-9d0e-4f1a-8b2c-4d5e6f7a8b9c",
      "name": "Rhône Audit & Conseil",
      "website": "https://www.rhone-audit.example",
      "contacts": 1,
      "created_at": "2025-10-01T14:30:00Z"
    }
  ]
}

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.