Skip to main content
Knowledge Query provides a structured interface for enabling the retrieval of precise and typed data from Cala’s knowledge base. The query endpoint uses an intuitive path-based syntax that lets you:
  • Navigate relationships between entities using dot notation
  • Filter results by applying conditions directly in the path
  • Access nested attributes across multiple entity relationships
  • Get structured, typed responses ready for your applications

​
Query syntax

Build queries using dot notation and operators:
OperatorMeaningExample
.Navigate relationships and access propertiesOpenAI.founded.year
=Filter by Exact matchstartups.location=Spain
!=Excludestartups.location!=US
>Greater thanstartups.funding>10M
<Less thanstartups.funding<50M
<=Less than or equalstartups.funding<=50M
Chain filters with dots: startups.location=Spain.funding>10M.funding<50M

​
Example:

Query startups in Spain with funding between €10M and €50M — no natural language needed, just structured path syntax: 
{"input": "startups.location=Spain.funding>10M.funding<50M"}
Every response includes two parts:

Structured Results

Typed, filterable data — not paragraphs of text. Each result is a structured object with consistent fields.
{
  "results": [
    {
      "company": "Amenitiz",
      "sector": "Hospitality SaaS",
      "funding_amount": "€38.9M",
      "round_type": "Series B",
      "year": 2025
    },
    {
      "company": "H2SITE",
      "sector": "Hydrogen Energy",
      "funding_amount": "€36M ($37.2M)",
      "round_type": "Series B",
      "year": 2025
    },
    {
      "company": "Fracttal",
      "sector": "AI Maintenance",
      "funding_amount": "€29.8M ($35M)",
      "round_type": "Series B",
      "year": 2026
    },
    {
      "company": "Heura",
      "sector": "Plant-based Foods",
      "funding_amount": "€40M",
      "round_type": "Total (multiple rounds)",
      "year": 2023
    },
    {
      "company": "Housfy",
      "sector": "Real Estate",
      "funding_amount": "€30M",
      "round_type": "Series B",
      "year": 2022
    },
    {
      "company": "Highlight Therapeutics",
      "sector": "Biotech",
      "funding_amount": "€37.6M",
      "round_type": "Venture Round",
      "year": 2024
    },
    {
      "company": "011h",
      "sector": "Construction Tech",
      "funding_amount": "€40.4M",
      "round_type": "Venture Round",
      "year": 2024
    },
    {
      "company": "Kreios Space",
      "sector": "Satellite Tech",
      "funding_amount": "€10.6M",
      "round_type": "Seed",
      "year": 2025
    },
    {
      "company": "Internxt",
      "sector": "Security/Storage",
      "funding_amount": "€10.9M",
      "round_type": "Seed",
      "year": 2020
    },
    {
      "company": "Nomad Solar Energy",
      "sector": "Solar Energy",
      "funding_amount": "€15M",
      "round_type": null,
      "year": null
    },
    {
      "company": "Universal DX",
      "sector": "Healthcare",
      "funding_amount": "€20M",
      "round_type": null,
      "year": null
    },
    {
      "company": "Maisa AI",
      "sector": "AI",
      "funding_amount": "€30M",
      "round_type": null,
      "year": null
    },
    {
      "company": "Reveni",
      "sector": null,
      "funding_amount": "€17.3M",
      "round_type": null,
      "year": null
    }
  ]
}
13 startups returned — each with company name, sector, funding amount, round type, and year. This is structured data, not text to parse.
Every company in the results is automatically linked to a Cala entity with a unique ID and type.
{
  "entities": [
    {"id": 33051, "name": "Amenitiz", "entity_type": "ORG"},
    {"id": 52552, "name": "H2SITE", "entity_type": "ORG"},
    {"id": 30141, "name": "Fracttal", "entity_type": "ORG"},
    {"id": 14079, "name": "Heura", "entity_type": "ORG"},
    {"id": 33052, "name": "Housfy", "entity_type": "ORG"},
    {"id": 36473, "name": "Highlight Therapeutics", "entity_type": "ORG"},
    {"id": 916, "name": "011h", "entity_type": "ORG"},
    {"id": 36472, "name": "Kreios Space", "entity_type": "ORG"},
    {"id": 37132, "name": "Internxt", "entity_type": "ORG"},
    {"id": 36468, "name": "Nomad Solar Energy", "entity_type": "ORG"},
    {"id": 57396, "name": "Universal DX", "entity_type": "ORG"},
    {"id": 19, "name": "Maisa AI", "entity_type": "ORG"},
    {"id": 1083, "name": "Reveni", "entity_type": "ORG"}
  ]
}
Use any entity ID to get the full profile: GET /v1/knowledge/entities/33051 returns everything Cala knows about Amenitiz — founders, executives, HQ, employee count, and more.

​
More query examples

{"input": "OpenAI.founded.year"}
{"input": "ibex35.companies.employee_count>2000"}
{"input": "companies.founder.incorporation>2020.previous_job=Google"}