Skip to main content
POST
/
v1
/
knowledge
/
query
Query
curl --request POST \
  --url https://api.cala.ai/v1/knowledge/query \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "input": "startups.location=Spain.funding>10M.funding<50M"
}
'
{
  "entities": [
    {
      "entity_type": "ORG",
      "id": 1160,
      "name": "OpenAI"
    }
  ],
  "results": [
    {
      "co_founders": "Elisenda Bou-Balust and Issey Masuda Mora",
      "description": "Develops explainable-AI data pipelines that enable corporations to fuse internal data with public sources while maintaining audit trails",
      "founded": "2025",
      "location": "Barcelona",
      "name": "Cala AI",
      "team_size": "20"
    }
  ]
}

Authorizations

​
X-API-KEY
string
header
required

Body

application/json
​
input
string
required
Example:

"startups.location=Spain.funding>10M.funding<50M"

Response

Successful Response

Response in case of a successful structured query.

​
results
Results · object[]
required

A list of structured results for the query. Shape and schema will be determined by the query.

Example:
[
  {
    "co_founders": "Elisenda Bou-Balust and Issey Masuda Mora",
    "description": "Develops explainable-AI data pipelines that enable corporations to fuse internal data with public sources while maintaining audit trails",
    "founded": "2025",
    "location": "Barcelona",
    "name": "Cala AI",
    "team_size": "20"
  }
]
​
entities
Entity · object[]
required

Entities recognized in the answer.