> ## 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. # Query > Search verified knowledge using structured dot-notation query syntax for filtering entities by attributes. Returns a structured array of matching results plus entities. The input field is called "input" (not "query"). Examples: `{"input": "startups.location=Spain.funding>10M.funding<=50M"}` `{"input": "companies.industry=fintech.founded_year>=2020"}` `{"input": "people.role=CEO.company.industry=AI"}` Use this when: You need to filter/search entities by specific attributes (location, funding, industry, year, etc.). For free-text questions use `knowledge_search`. To look up a known entity by name use `entity_search`. ## OpenAPI ````yaml https://api.cala.ai/openapi.json post /v1/knowledge/query openapi: 3.1.0 info: title: Cala AI summary: Verified, reliable knowledge one API call away description: > ### Knowledge Search Let's you search for verified knowledge to empower your AI Agent with the **right context**. ### Knowledge Entities Get information about entities, **structured** and reliable. version: Beta 1.0 servers: - url: https://api.cala.ai/ security: [] paths: /v1/knowledge/query: post: tags: - API v1 - Knowledge summary: Query description: >- Search verified knowledge using structured dot-notation query syntax for filtering entities by attributes. Returns a structured array of matching results plus entities. The input field is called "input" (not "query"). Examples: `{"input": "startups.location=Spain.funding>10M.funding<=50M"}` `{"input": "companies.industry=fintech.founded_year>=2020"}` `{"input": "people.role=CEO.company.industry=AI"}` Use this when: You need to filter/search entities by specific attributes (location, funding, industry, year, etc.). For free-text questions use `knowledge_search`. To look up a known entity by name use `entity_search`. operationId: knowledge_query requestBody: content: application/json: schema: $ref: '#/components/schemas/QueryRequest' required: true responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/QueryResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '429': description: Too many requests (rate limit exceeded) content: application/json: example: error: rate_limit_exceeded message: Rate limit exceeded. Too many requests. security: - APIKeyHeader: [] components: schemas: QueryRequest: properties: input: type: string title: Input examples: - startups.location=Spain.funding>10M.funding<50M return_entities: type: boolean title: Return Entities description: Whether to return the entities identified in the query response. default: true examples: - true type: object required: - input title: QueryRequest example: input: startups.location=Spain.funding>10M.funding<50M QueryResponse: properties: results: items: additionalProperties: true type: object type: array title: Results description: >- A list of structured results for the query. Shape and schema will be determined by the query. examples: - - company: Amenitiz funding_amount: €38.9M round_type: Series B sector: Hospitality SaaS year: 2025 - company: H2SITE funding_amount: €36M ($37.2M) round_type: Series B sector: Hydrogen Energy year: 2025 - company: Fracttal funding_amount: €29.8M ($35M) round_type: Series B sector: AI Maintenance year: 2026 entities: anyOf: - items: $ref: '#/components/schemas/EntityMention' type: array - type: 'null' title: Entities description: Entities identified in the query response. type: object required: - results - entities title: QueryResponse description: Response in case of a successful structured query. example: entities: - entity_type: Company id: e2932ee7-7b57-42b7-8c58-cdfcdf56ceb5 mentions: - Amenitiz name: Amenitiz - entity_type: Company id: e843fc48-8339-4c99-a6e2-e7fb1cc738b1 mentions: - H2SITE name: H2SITE - entity_type: Company id: af3ff4b5-27a9-45d5-8c67-b656cb38e6b8 mentions: - Fracttal name: Fracttal results: - company: Amenitiz funding_amount: €38.9M round_type: Series B sector: Hospitality SaaS year: 2025 - company: H2SITE funding_amount: €36M ($37.2M) round_type: Series B sector: Hydrogen Energy year: 2025 - company: Fracttal funding_amount: €29.8M ($35M) round_type: Series B sector: AI Maintenance year: 2026 HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError EntityMention: properties: id: type: string format: uuid title: Id description: The ID of the entity examples: - 0abe9580-5abb-46df-9506-5dc784520b69 name: type: string title: Name description: The name of the entity examples: - Altano Energy entity_type: type: string enum: - Entity - Animal - Award - Organization - Company - EducationalInstitution - Person - Event - GPE - Country - CountryRegion - Industry - FinancialMetric - Group - CorporateEvent - PrivateCompanyFundingRound - Facility - Location - Organism - Plant - Product - Sanction - WorkOfArt - Law - Language - Exchange - Future - Commodity - PositioningMetric - MacroIndicatorPublication - MacroIndicator title: Entity Type description: The type of the entity examples: - Company mentions: items: type: string type: array title: Mentions description: Mentions of this entity in the response. examples: - - Altano Energy - Altano type: object required: - id - name - entity_type - mentions title: EntityMention ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: APIKeyHeader: type: apiKey in: header name: X-API-KEY ````