Find a company · API reference

Query parameters

querystringrequired
Company name (or a fragment). Case- and accent-insensitive.

Response

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

matchesobject[]
Show child attributes
- idstring
- namestring · nullable
- statusstring · nullable
- sectorstring · nullable
- asset_typestring · nullable
- fundsstring[]

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/find_company?query=DLOM" \
  -H "Authorization: Bearer $JOLV_TOKEN"

Python

import os, requests

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

Example response (illustrative values)

200

{
  "matches": [
    {
      "id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
      "name": "Nordlicht Software",
      "status": "active",
      "sector": "Software",
      "asset_type": "equity",
      "funds": [
        "Buyout I"
      ]
    }
  ]
}

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.