Skip to main content
POST
/
v1
/
knowledge
/
search
Search
curl --request POST \
  --url https://api.cala.ai/v1/knowledge/search \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "input": "What are the most promising climate tech startups in Southern Europe?"
}
'
{
  "content": "**Altano Energy (Spain)** — Madrid-based, developing renewable energy projects across Spain. Altano secured €60M Series C in 2025 from M&G Investments and Pioneer Point Partners.",
  "context": [
    {
      "content": "Altano Energy - €60m (Series C, Jul 2025). Develops and operates renewable energy projects across Spain...",
      "id": "732e1954-9538-4fbc-a565-db2f8c07ad4e"
    }
  ],
  "entities": [
    {
      "entity_type": "Company",
      "id": "0abe9580-5abb-46df-9506-5dc784520b69",
      "mentions": [
        "Altano Energy",
        "Altano"
      ],
      "name": "Altano Energy"
    }
  ],
  "explainability": [
    {
      "content": "Altano Energy secured a €60 million Series C round in July 2025 from Pioneer Point Partners and M&G Investments.",
      "references": [
        "f22a1a96-6234-48d7-95c2-8b049f00fdab"
      ]
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.cala.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

X-API-KEY
string
header
required

Body

application/json
input
string
required
Example:

"What are the most promising climate tech startups in Southern Europe?"

explainability
boolean
default:true

Whether to generate explainability for the answer.

Example:

true

return_entities
boolean
default:true

Whether to return the entities identified in the answer.

Example:

true

Response

Successful Response

The answer to the user's input with the reasoning steps and the context that support the answer.

content
string
required

A succinct answer to the user's input in Markdown format.

Example:

"**Altano Energy (Spain)** — Madrid-based, developing renewable energy projects across Spain. Altano secured €60M Series C in 2025 from M&G Investments and Pioneer Point Partners."

explainability
ReasoningSteps · object[] | null
required

A list of reasoning steps to get to that answer.

context
KnowBit · object[]
required

A list of facts that support the answer.

entities
EntityMention · object[] | null
required

Entities identified in the answer.