{"openapi":"3.1.0","info":{"title":"Cala AI","summary":"Verified, reliable knowledge one API call away","description":"\n### Knowledge Search\n\nLet's you search for verified knowledge to empower your AI Agent with the **right context**.\n\n### Knowledge Entities\n\nGet information about entities, **structured** and reliable.\n","version":"Beta 1.0"},"servers":[{"url":"https://api.cala.ai/"}],"paths":{"/v1/knowledge/search":{"post":{"tags":["API v1","Knowledge"],"summary":"Search","description":"Search verified knowledge and get back a sourced, prose answer. Best when you have a question and\nwant a researched narrative with citations — not a list of entities.\n\nReturns markdown content with explainability, source citations, and matching entities.\n\n\nInput can be natural language or Dot-Notation Syntax — both work the same here, only the output\nshape differs from `knowledge_query`.\n\n\nDot-Notation Syntax lets you express filters and structure directly:\n\n- `.` navigates entity/topic → attribute → nested facet (e.g. `companies.industry`)\n\n- `=` `!=` `>` `<` `>=` `<=` filter a facet\n\n- `AND` / `OR` combine multiple values of the *same* field (e.g. `investors=A AND B`,\n  `series=A OR B`); chain different fields with `.`\n\n- `order_by=field ASC|DESC` and `limit=N` steer which results surface, not just their order\n\n- `return(f1, f2, ...)` focuses the answer on specific fields (a strict field projection on\n  `knowledge_query`)\n\n- Clauses can appear in any order\n\n- Numeric fields may come back as approximate strings (e.g. \"over 100M\", \"~206,753\") —\n  synthesize, don't treat as exact\n\n\nExamples:\n\n`{\"input\": \"Who founded Anthropic and what is their background?\"}`\n\n`{\"input\": \"people.role=CEO.company.industry=renewable_energy\"}`\n\n`{\"input\": \"What regulations affect fintech companies in the EU?\"}`\n\n\nUse this when: You want a sourced, prose answer to a question.\nNOT for: A structured list of matching entities — use `knowledge_query` instead (same input,\ndifferent output). NOT for: Looking up one specific entity by name — use `entity_search`.","operationId":"knowledge_search","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"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":[]}]}},"/v1/knowledge/query":{"post":{"tags":["API v1","Knowledge"],"summary":"Query","description":"Search verified knowledge and get back a structured list of matching entities. Same input as\n`knowledge_search` — natural language or Dot-Notation Syntax — only the output shape differs.\n\nReturns a structured array of matching results plus entities. The input field is called \"input\" (not \"query\").\n\n\nDot-Notation Syntax lets you express filters and structure directly:\n\n- `.` navigates entity/topic → attribute → nested facet (e.g. `companies.industry`)\n\n- `=` `!=` `>` `<` `>=` `<=` filter a facet\n\n- `AND` / `OR` combine multiple values of the *same* field (e.g. `investors=A AND B`,\n  `series=A OR B`); chain different fields with `.`\n\n- `order_by=field ASC|DESC` and `limit=N` steer which results surface, not just their order\n\n- `return(f1, f2, ...)` projects the result to just those fields (always keep an identity field\n  like `name`)\n\n- Clauses can appear in any order\n\n- Numeric fields may come back as approximate strings (e.g. \"over 100M\", \"~206,753\") —\n  synthesize, don't treat as exact\n\n\nExamples:\n\n`{\"input\": \"Which biotech companies were founded after 2020?\"}`\n\n`{\"input\": \"companies.industry=fintech.founded_year>=2020\"}`\n\n`{\"input\": \"people.role=CEO.company.industry=AI\"}`\n\n\nUse this when: You want a filtered, structured list of entities back.\nNOT for: A researched prose answer with citations — use `knowledge_search` instead (same input,\ndifferent output). NOT for: Looking up one specific 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/ErrorResponse"}}}},"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":[]}]}},"/v1/entities":{"get":{"tags":["API v1","Entities"],"summary":"Search Entities","description":"Find real-world entities by name with fuzzy matching — spans many domains and keeps growing:\nbusiness (companies, investors, funding rounds, M&A, industries, products), people, legal (laws,\nregulations, sanctions), geography (countries, places), finance/macro (financial metrics, macro\nindicators, FX rates), and more — treat this list as illustrative, not exhaustive. Use for \"look up\nX\" / \"who/what is X\" / \"X's profile, properties, or relationships\" when you know (or partially know)\nthe name. Optionally filter by entity type.\n\nReturns an array of matching entities with IDs that feed `entity_retrieval` (entity data) and\n`entity_introspection` (available fields).\n\n\nExamples:\n\n`{\"name\": \"OpenAI\"}`\n\n`{\"name\": \"Elon Musk\", \"entity_types\": [\"Person\"]}`\n\n`{\"name\": \"Berlin\", \"entity_types\": [\"GPE\"]}`\n\n`{\"name\": \"GDPR\", \"entity_types\": [\"Law\"]}`\n\n\nUse this when: You know the name and want the entity ID or a quick profile. Use `knowledge_query`\ninstead for attribute-based filtering without a name.","operationId":"entity_search","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","minLength":1,"description":"Entity name to search for","title":"Name"},"description":"Entity name to search for","example":"Fracttal"},{"name":"entity_types","in":"query","required":false,"schema":{"type":"array","items":{"enum":["Entity","Animal","Award","Organization","Company","EducationalInstitution","IntergovernmentalOrganization","Person","Event","GPE","Country","CountrySubdivision","DependentTerritory","Municipality","Continent","Currency","Industry","FinancialMetric","Group","CorporateEvent","PrivateCompanyFundingRound","Facility","Location","Organism","Plant","Product","Sanction","WorkOfArt","Law","Language","Exchange","Future","Commodity","PositioningMetric","MacroIndicatorPublication","MacroIndicator","ForeignExchangeRate","CountryRegion"],"type":"string"},"description":"Filter by entity types","default":[],"title":"Entity Types"},"description":"Filter by entity types"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum number of results","default":20,"title":"Limit"},"description":"Maximum number of results"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntitySearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too many requests (rate limit exceeded)","content":{"application/json":{"example":{"error":"rate_limit_exceeded","message":"Rate limit exceeded. Too many requests."}}}}}}},"/v1/entities/{entity_id}/introspection":{"get":{"tags":["API v1","Entities"],"summary":"Entity Introspection","description":"Get the field schema for a real-world entity by its numeric UUID — the schema spans many domains,\nillustrative not exhaustive. Use to look up / find out what an entity is queryable for before\npulling its profile. Returns the available properties, relationships, and numerical observations\nyou can request from `entity_retrieval`.\n\n\nExamples:\n\n`GET /entities/c6772802-bdbc-4778-91e9-cd3d27d008d5/introspection`\n\n`GET /entities/e5bb591a-d308-4aa5-9672-96046d366cde/introspection`\n\n\nUse this when: You have an entity UUID and need to discover which attributes and relationships exist before\nquerying. Use `entity_retrieval` to fetch data, or `entity_search` first if you only have a name.","operationId":"entity_introspection","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"entity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Entity Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntrospectionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too many requests (rate limit exceeded)","content":{"application/json":{"example":{"error":"rate_limit_exceeded","message":"Rate limit exceeded. Too many requests."}}}}}}},"/v1/entities/{entity_id}":{"post":{"tags":["API v1","Entities"],"summary":"Entities","description":"Get typed entity data by its numeric UUID — company, person, place, law, financial instrument, and\nmore (the schema spans many domains, illustrative not exhaustive) — in two modes:\n\n\n- **Coarse (no body):** returns only the default property set. No relationships, no numerical\n  observations. Use only when a rough profile is enough.\n\n- **Projection (body):** name exact `properties`, `relationships`, and `numerical_observations` to\n  get back. The only way to get relationships or time-series data, and the most token-efficient\n  read. Available fields vary by entity type and must be *queryable* for that specific entity — run\n  `entity_introspection` first to discover them; projecting blind wastes round-trips and may hit\n  empty or non-queryable edges.\n\n\nPass the entity UUID in the URL path (e.g. `POST /entities/{entity_id}`). Optionally send a JSON body\nto specify which properties and relationships to return; if omitted, default properties are returned.\n\nExamples (path + optional body):\n\n`POST /entities/c6772802-bdbc-4778-91e9-cd3d27d008d5`\n\nOptional body: `{\"properties\": [\"name\", \"aliases\", \"registered_address\", \"employee_count\"], \"relationships\": {\"outgoing\": {\"IS_ULTIMATE_PARENT\": {\"limit\": 5}}, \"incoming\": {\"IS_CEO_OF\": {}}}}`\n\n\nUse this when: You already have an entity UUID (from `entity_search`, `knowledge_search`, or `knowledge_query`\nresults) and need entity data. Use `entity_search` first if you only have a name, and `entity_introspection`\nfirst if you need a projection.","operationId":"retrieve_entity","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"entity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Entity Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityQuery","description":"Optional query to specify which properties and relationships to return for the entity. If it is not provided, default properties will be returned.","examples":[{"properties":["name","aliases","registered_address","employee_count"],"relationships":{"outgoing":{"IS_REGISTERED_IN":{"limit":2,"offset":0}},"incoming":{"IS_BOARD_MEMBER_OF":{"limit":2,"offset":2}}},"numerical_observations":{"FinancialMetric":["1d3eae40-0ba8-5baf-9907-6a4823b067bb"]}}]}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetEntityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too many requests (rate limit exceeded)","content":{"application/json":{"example":{"error":"rate_limit_exceeded","message":"Rate limit exceeded. Too many requests."}}}}}}}},"components":{"schemas":{"Answer":{"properties":{"content":{"type":"string","title":"Content","description":"A succinct answer to the user's input in Markdown format.","examples":["**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":{"anyOf":[{"items":{"$ref":"#/components/schemas/ReasoningSteps"},"type":"array"},{"type":"null"}],"title":"Explainability","description":"A list of reasoning steps to get to that answer."},"context":{"items":{"$ref":"#/components/schemas/KnowBit"},"type":"array","title":"Context","description":"A list of facts that support the answer."},"entities":{"anyOf":[{"items":{"$ref":"#/components/schemas/EntityMention"},"type":"array"},{"type":"null"}],"title":"Entities","description":"Entities identified in the answer."}},"type":"object","required":["content","explainability","context","entities"],"title":"Answer","description":"The answer to the user's input with the reasoning steps and the context that support the answer.","example":{"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"]}]}},"Document":{"properties":{"name":{"type":"string","title":"Name","description":"The name or title of the document.","examples":["Europe's top 25 climate tech funding rounds this year"]},"url":{"type":"string","minLength":1,"format":"uri","title":"URL","description":"The URL of the document.","examples":["https://www.impactloop.com/artikel/europe-s-25-largest-climate-tech-fundraises-funding-2025-and-the-investors-behind-them"]}},"type":"object","required":["name","url"],"title":"Document","description":"Specific text, report, article, or file that contains the information."},"Entity":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"The ID of the entity","examples":["e5bb591a-d308-4aa5-9672-96046d366cde"]},"name":{"type":"string","title":"Name","description":"The name of the entity","examples":["OpenAI"]},"entity_type":{"type":"string","enum":["Entity","Animal","Award","Organization","Company","EducationalInstitution","IntergovernmentalOrganization","Person","Event","GPE","Country","CountrySubdivision","DependentTerritory","Municipality","Continent","Currency","Industry","FinancialMetric","Group","CorporateEvent","PrivateCompanyFundingRound","Facility","Location","Organism","Plant","Product","Sanction","WorkOfArt","Law","Language","Exchange","Future","Commodity","PositioningMetric","MacroIndicatorPublication","MacroIndicator","ForeignExchangeRate","CountryRegion"],"title":"Entity Type","description":"The type of the entity","examples":["Company"]},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"A short description of the entity","examples":["An American multinational technology company."]}},"type":"object","required":["id","name","entity_type"],"title":"Entity"},"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","IntergovernmentalOrganization","Person","Event","GPE","Country","CountrySubdivision","DependentTerritory","Municipality","Continent","Currency","Industry","FinancialMetric","Group","CorporateEvent","PrivateCompanyFundingRound","Facility","Location","Organism","Plant","Product","Sanction","WorkOfArt","Law","Language","Exchange","Future","Commodity","PositioningMetric","MacroIndicatorPublication","MacroIndicator","ForeignExchangeRate","CountryRegion"],"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"},"EntityQuery":{"properties":{"properties":{"items":{"type":"string"},"type":"array","title":"Properties","description":"List of entity property names to query","default":[],"examples":[["name","aliases","registered_address","employee_count"]]},"relationships":{"$ref":"#/components/schemas/EntityQueryRelationships","description":"Relationship queries"},"numerical_observations":{"additionalProperties":true,"type":"object","title":"Numerical Observations","description":"UUIDs of the numerical observations to query","examples":[{"FinancialMetric":["1d3eae40-0ba8-5baf-9907-6a4823b067bb"]}]}},"type":"object","title":"EntityQuery","example":{"numerical_observations":{"FinancialMetric":["1d3eae40-0ba8-5baf-9907-6a4823b067bb"]},"properties":["name","aliases","registered_address","employee_count"],"relationships":{"incoming":{"IS_BOARD_MEMBER_OF":{"limit":2,"offset":2}},"outgoing":{"IS_REGISTERED_IN":{"limit":2,"offset":0}}}}},"EntityQueryRelationships":{"properties":{"outgoing":{"additionalProperties":true,"type":"object","title":"Outgoing","description":"Outgoing relationship","default":{},"examples":[{"IS_REGISTERED_IN":{"limit":2,"offset":0}}]},"incoming":{"additionalProperties":true,"type":"object","title":"Incoming","description":"Incoming relationship","default":{},"examples":[{"IS_BOARD_MEMBER_OF":{"limit":2,"offset":2}}]}},"type":"object","title":"EntityQueryRelationships"},"EntityRelationships":{"properties":{"outgoing":{"additionalProperties":true,"type":"object","title":"Outgoing","description":"Outgoing relationship type names.","examples":[{"IS_REGISTERED_IN":[{"entity_type":"Country","id":"37a1f0f5-f5ef-4b63-b3d8-14f5636be703","name":"United States","properties":{"sources":[{"date":"2026-04-15","document":"https://indianexpress.com/article/trending/top-10-listing/top-10-tech-companies-in-the-world-by-market-cap-2025-9977264","name":"indianexpress.com"}],"id":"bb76eabf-d089-5a3a-a4a3-2ab2b38a2cac"}}]}]},"incoming":{"additionalProperties":true,"type":"object","title":"Incoming","description":"Incoming relationship type names.","examples":[{"IS_BOARD_MEMBER_OF":[{"entity_type":"Person","id":"1118056e-3ddc-4856-8855-9f6179924d25","name":"William Campbell","properties":{"valid_until":"2015-03-13","sources":[{"date":"2014-03-05","document":"https://www.sec.gov/Archives/edgar/data/320193/000119312514084697/d684095d8k.htm","name":"SEC"},{"date":"2015-03-13","document":"https://www.sec.gov/Archives/edgar/data/320193/000110465915019336/a15-5624_18k.htm","name":"SEC"}],"id":"b4ab6a95-9b90-4c70-bcde-343f34df25ca","valid_since":"2014-02-28"}},{"entity_type":"Person","id":"39326f52-abf3-44f9-a552-ef183daa68f0","name":"James A. Bell","properties":{"valid_until":"2024-02-28","sources":[{"date":"2015-10-02","document":"https://www.sec.gov/Archives/edgar/data/320193/000119312515336615/d10101d8k.htm","name":"SEC"},{"date":"2016-03-01","document":"https://www.sec.gov/Archives/edgar/data/320193/000119312516488223/d150918d8k.htm","name":"SEC"},{"date":"2017-03-01","document":"https://www.sec.gov/Archives/edgar/data/320193/000119312517064019/d342218d8k.htm","name":"SEC"},{"date":"2018-02-14","document":"https://www.sec.gov/Archives/edgar/data/320193/000119312518045761/d374908d8k.htm","name":"SEC"},{"date":"2019-03-04","document":"https://www.sec.gov/Archives/edgar/data/320193/000032019319000032/copyofreference8-kform8xkq.htm","name":"SEC"},{"date":"2020-02-27","document":"https://www.sec.gov/Archives/edgar/data/320193/000119312520050884/d865740d8k.htm","name":"SEC"}],"id":"93adb3c1-049f-4dc4-a363-7b368f69d76f","valid_since":"2015-10-01"}}]}]}},"type":"object","title":"EntityRelationships","description":"Outgoing and incoming relationship types for an entity."},"EntitySearchResponse":{"properties":{"entities":{"items":{"$ref":"#/components/schemas/Entity"},"type":"array","title":"Entities","description":"List of entities matching the search query, ordered by relevance (most relevant first)."}},"type":"object","required":["entities"],"title":"EntitySearchResponse","description":"Response containing a list of entities matching the search query.","example":{"entities":[{"description":"An American multinational technology company.","entity_type":"Company","id":"e5bb591a-d308-4aa5-9672-96046d366cde","name":"OpenAI"}]}},"Error":{"properties":{"error_type":{"$ref":"#/components/schemas/ErrorType"},"message":{"type":"string","title":"Message"}},"type":"object","required":["error_type","message"],"title":"Error"},"ErrorResponse":{"properties":{"response_type":{"type":"string","const":"ERROR","title":"Response Type","default":"ERROR"},"error":{"$ref":"#/components/schemas/Error"}},"type":"object","required":["error"],"title":"ErrorResponse"},"ErrorType":{"type":"string","enum":["internal_server_error","service_unavailable_error","format_error","session_not_found_error","entity_not_found_error","request_not_found_error","bad_gateway_error"],"title":"ErrorType"},"GetEntityResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"The ID of the entity"},"name":{"type":"string","title":"Name","description":"The name of the entity"},"entity_type":{"type":"string","enum":["Entity","Animal","Award","Organization","Company","EducationalInstitution","IntergovernmentalOrganization","Person","Event","GPE","Country","CountrySubdivision","DependentTerritory","Municipality","Continent","Currency","Industry","FinancialMetric","Group","CorporateEvent","PrivateCompanyFundingRound","Facility","Location","Organism","Plant","Product","Sanction","WorkOfArt","Law","Language","Exchange","Future","Commodity","PositioningMetric","MacroIndicatorPublication","MacroIndicator","ForeignExchangeRate","CountryRegion"],"title":"Entity Type","description":"The type of the entity"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"A short description of the entity"},"properties":{"additionalProperties":true,"type":"object","title":"Properties","description":"List of property names available for this entity (e.g. id, name, currency).","examples":[{"aliases":{"sources":[],"value":["Apple Computer, Inc.","Apple","AAPL","Apple Inc.","Apple (AAPL)","Apple Computer Inc.","Apple Computer Company","NASDAQ: AAPL","Apple — AAPL (NASDAQ: AAPL)","Apple (NASDAQ: AAPL)"]},"employee_count":{"sources":[{"date":"2026-04-15","document":"https://www.stockanalysis.com/stocks/aapl/employees/","name":"Apple (AAPL) Number of Employees 1994-2025"}],"value":166000},"name":{"sources":[{"date":"2026-02-26","document":{"endpoint":"https://efts.sec.gov/LATEST/search-index?q=%22APPLE+INC%22","params":{},"response_hash":"3f0354a291ad77088d55bd2577294a85d5ba3c1b9ae0aa5a58c53bb24ed49111"},"name":"SEC"}],"value":"APPLE INC"},"registered_address":{"sources":[{"date":"2026-01-01","document":"https://www.creditsafe.com/business-index/en-gb/company/apple-inc-us22139727","name":"Apple Inc Credit Report"},{"date":"2025-07-25","document":"https://www.bbb.org/us/ca/cupertino/profile/home-electronics/apple-inc-1216-198239","name":"About"},{"date":"2026-04-16","document":"https://labormarketinfo.edd.ca.gov/aspdotnet/databrowsing/empDetails.aspx?menuchoice=emp&geogArea=0604000085&empId=008264145","name":"labormarketinfo.edd.ca.gov"}],"value":"One Apple Park Way, Cupertino, CA 95014, USA"}}]},"relationships":{"$ref":"#/components/schemas/EntityRelationships","description":"Outgoing and incoming relationship types. This field is empty unless relationships.incoming and/or relationships.outgoing are provided in the request."},"numerical_observations":{"items":{},"type":"array","title":"Numerical Observations","description":"Numerical observations keyed by observation type.","examples":[[{"data":[{"origin":{"name":"10-Q","published_time":"2026-01-30T00:00:00Z","source":"SEC","url":"https://www.sec.gov/Archives/edgar/data/0000320193-26-000006/0000320193-26-000006-index.html"},"time":"2025-12-27T00:00:00Z","value":45317000000.0},{"origin":{"name":"10-K","published_time":"2025-10-31T00:00:00Z","source":"SEC","url":"https://www.sec.gov/Archives/edgar/data/0000320193-25-000079/0000320193-25-000079-index.html"},"time":"2025-09-27T00:00:00Z","value":35934000000.0},{"origin":{"name":"10-Q","published_time":"2026-01-30T00:00:00Z","source":"SEC","url":"https://www.sec.gov/Archives/edgar/data/0000320193-26-000006/0000320193-26-000006-index.html"},"time":"2025-09-27T00:00:00Z","value":35934000000.0}],"id":"1d3eae40-0ba8-5baf-9907-6a4823b067bb","name":"Cash and Cash Equivalents, at Carrying Value","properties":{"unit":"USD","aliases":[],"taxonomy":"us-gaap","cadence":"i"},"type":"FinancialMetric"}]]}},"type":"object","required":["id","name","entity_type","properties","relationships"],"title":"GetEntityResponse","description":"Response containing full entity profile","example":{"description":"Computer company founded in 1977 with headquarters in Cupertino, California","entity_type":"Company","id":"c6772802-bdbc-4778-91e9-cd3d27d008d5","name":"APPLE INC","numerical_observations":[{"data":[{"origin":{"name":"10-Q","published_time":"2026-01-30T00:00:00Z","source":"SEC","url":"https://www.sec.gov/Archives/edgar/data/0000320193-26-000006/0000320193-26-000006-index.html"},"time":"2025-12-27T00:00:00Z","value":45317000000.0},{"origin":{"name":"10-K","published_time":"2025-10-31T00:00:00Z","source":"SEC","url":"https://www.sec.gov/Archives/edgar/data/0000320193-25-000079/0000320193-25-000079-index.html"},"time":"2025-09-27T00:00:00Z","value":35934000000.0},{"origin":{"name":"10-Q","published_time":"2026-01-30T00:00:00Z","source":"SEC","url":"https://www.sec.gov/Archives/edgar/data/0000320193-26-000006/0000320193-26-000006-index.html"},"time":"2025-09-27T00:00:00Z","value":35934000000.0}],"id":"1d3eae40-0ba8-5baf-9907-6a4823b067bb","name":"Cash and Cash Equivalents, at Carrying Value","properties":{"unit":"USD","aliases":[],"taxonomy":"us-gaap","cadence":"i"},"type":"FinancialMetric"}],"properties":{"name":{"sources":[{"date":"2026-02-26","document":{"endpoint":"https://efts.sec.gov/LATEST/search-index?q=%22APPLE+INC%22","params":{},"response_hash":"3f0354a291ad77088d55bd2577294a85d5ba3c1b9ae0aa5a58c53bb24ed49111"},"name":"SEC"}],"value":"APPLE INC"},"aliases":{"sources":[],"value":["Apple Computer, Inc.","Apple","AAPL","Apple Inc.","Apple (AAPL)","Apple Computer Inc.","Apple Computer Company","NASDAQ: AAPL","Apple — AAPL (NASDAQ: AAPL)","Apple (NASDAQ: AAPL)"]},"registered_address":{"sources":[{"date":"2026-01-01","document":"https://www.creditsafe.com/business-index/en-gb/company/apple-inc-us22139727","name":"Apple Inc Credit Report"},{"date":"2025-07-25","document":"https://www.bbb.org/us/ca/cupertino/profile/home-electronics/apple-inc-1216-198239","name":"About"},{"date":"2026-04-16","document":"https://labormarketinfo.edd.ca.gov/aspdotnet/databrowsing/empDetails.aspx?menuchoice=emp&geogArea=0604000085&empId=008264145","name":"labormarketinfo.edd.ca.gov"}],"value":"One Apple Park Way, Cupertino, CA 95014, USA"},"employee_count":{"sources":[{"date":"2026-04-15","document":"https://www.stockanalysis.com/stocks/aapl/employees/","name":"Apple (AAPL) Number of Employees 1994-2025"}],"value":166000}},"relationships":{"incoming":{"IS_BOARD_MEMBER_OF":[{"entity_type":"Person","id":"1118056e-3ddc-4856-8855-9f6179924d25","name":"William Campbell","properties":{"valid_until":"2015-03-13","sources":[{"date":"2014-03-05","document":"https://www.sec.gov/Archives/edgar/data/320193/000119312514084697/d684095d8k.htm","name":"SEC"},{"date":"2015-03-13","document":"https://www.sec.gov/Archives/edgar/data/320193/000110465915019336/a15-5624_18k.htm","name":"SEC"}],"id":"b4ab6a95-9b90-4c70-bcde-343f34df25ca","valid_since":"2014-02-28"}},{"entity_type":"Person","id":"39326f52-abf3-44f9-a552-ef183daa68f0","name":"James A. Bell","properties":{"valid_until":"2024-02-28","sources":[{"date":"2015-10-02","document":"https://www.sec.gov/Archives/edgar/data/320193/000119312515336615/d10101d8k.htm","name":"SEC"},{"date":"2016-03-01","document":"https://www.sec.gov/Archives/edgar/data/320193/000119312516488223/d150918d8k.htm","name":"SEC"},{"date":"2017-03-01","document":"https://www.sec.gov/Archives/edgar/data/320193/000119312517064019/d342218d8k.htm","name":"SEC"},{"date":"2018-02-14","document":"https://www.sec.gov/Archives/edgar/data/320193/000119312518045761/d374908d8k.htm","name":"SEC"},{"date":"2019-03-04","document":"https://www.sec.gov/Archives/edgar/data/320193/000032019319000032/copyofreference8-kform8xkq.htm","name":"SEC"},{"date":"2020-02-27","document":"https://www.sec.gov/Archives/edgar/data/320193/000119312520050884/d865740d8k.htm","name":"SEC"}],"id":"93adb3c1-049f-4dc4-a363-7b368f69d76f","valid_since":"2015-10-01"}}]},"outgoing":{"IS_REGISTERED_IN":[{"entity_type":"Country","id":"37a1f0f5-f5ef-4b63-b3d8-14f5636be703","name":"United States","properties":{"sources":[{"date":"2026-04-15","document":"https://indianexpress.com/article/trending/top-10-listing/top-10-tech-companies-in-the-world-by-market-cap-2025-9977264","name":"indianexpress.com"}],"id":"bb76eabf-d089-5a3a-a4a3-2ab2b38a2cac"}}]}}}},"IntrospectionEntityRelationships":{"properties":{"outgoing":{"items":{"type":"string"},"type":"array","title":"Outgoing","description":"Outgoing relationship type names.","examples":[["IS_ULTIMATE_PARENT_OF","IS_REGISTERED_IN","OPERATES_IN_INDUSTRY","IS_DIRECT_PARENT_OF","IS_BENEFICIARY_OWNER_OF","HAS_HEADQUARTERS_IN","PARTICIPATES_IN_CORPORATE_EVENT"]]},"incoming":{"items":{"type":"string"},"type":"array","title":"Incoming","description":"Incoming relationship type names.","examples":[["IS_CFO_OF","IS_SUBSIDIARY_OF","IS_BOARD_MEMBER_OF","IS_BENEFICIARY_OWNER_OF","IS_CEO_OF"]]}},"type":"object","title":"IntrospectionEntityRelationships","description":"Outgoing and incoming relationship types for an entity."},"IntrospectionResponse":{"properties":{"properties":{"items":{"type":"string"},"type":"array","title":"Properties","description":"List of property names available for this entity (e.g. id, name, currency).","examples":[["cik","headquarters_address","lei","registered_address","founding_date","esg_policy","legal_name","employee_count","bics","name","aliases","id"]]},"relationships":{"$ref":"#/components/schemas/IntrospectionEntityRelationships","description":"Outgoing and incoming relationship types."},"numerical_observations":{"additionalProperties":true,"type":"object","title":"Numerical Observations","description":"List of numerical observation names available for this entity.","examples":[{"FinancialMetric":[{"cadence":"i","description":"Amount of currency on hand as well as demand deposits with banks or financial institutions. Includes other kinds of accounts that have the general characteristics of demand deposits. Also includes short-term, highly liquid investments that are both readily convertible to known amounts of cash and so near their maturity that they present insignificant risk of changes in value because of changes in interest rates. Excludes cash and cash equivalents within disposal group and discontinued operation.","id":"1d3eae40-0ba8-5baf-9907-6a4823b067bb","name":"Cash and Cash Equivalents, at Carrying Value","taxonomy":"us-gaap","unit":"USD"}]}]}},"type":"object","required":["properties","relationships","numerical_observations"],"title":"IntrospectionResponse","description":"Response containing the introspection of an entity.","example":{"numerical_observations":{"FinancialMetric":[{"cadence":"i","description":"Amount of currency on hand as well as demand deposits with banks or financial institutions. Includes other kinds of accounts that have the general characteristics of demand deposits. Also includes short-term, highly liquid investments that are both readily convertible to known amounts of cash and so near their maturity that they present insignificant risk of changes in value because of changes in interest rates. Excludes cash and cash equivalents within disposal group and discontinued operation.","id":"1d3eae40-0ba8-5baf-9907-6a4823b067bb","name":"Cash and Cash Equivalents, at Carrying Value","taxonomy":"us-gaap","unit":"USD"}]},"properties":["cik","headquarters_address","lei","registered_address","founding_date","esg_policy","legal_name","employee_count","bics","name","aliases","id"],"relationships":{"incoming":["IS_CFO_OF","IS_SUBSIDIARY_OF","IS_BOARD_MEMBER_OF","IS_BENEFICIARY_OWNER_OF","IS_CEO_OF"],"outgoing":["IS_ULTIMATE_PARENT_OF","IS_REGISTERED_IN","OPERATES_IN_INDUSTRY","IS_DIRECT_PARENT_OF","IS_BENEFICIARY_OWNER_OF","HAS_HEADQUARTERS_IN","PARTICIPATES_IN_CORPORATE_EVENT"]}}},"KnowBit":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"The id of the KnowBit.","examples":["732e1954-9538-4fbc-a565-db2f8c07ad4e"]},"content":{"type":"string","title":"Content","description":"The information contained in the KnowBit.","examples":["Altano Energy - €60m (Series C, Jul 2025). Develops and operates renewable energy projects across Spain..."]},"origins":{"items":{"$ref":"#/components/schemas/Origin"},"type":"array","title":"Origins","description":"The origins from which the KnowBit was extracted."}},"type":"object","required":["id","content","origins"],"title":"KnowBit","description":"A KnowBit is like a fact, a piece of information that supports the answer."},"Origin":{"properties":{"source":{"$ref":"#/components/schemas/Source"},"document":{"$ref":"#/components/schemas/Document"},"breadcrumb":{"items":{"type":"string"},"type":"array","title":"Breadcrumb","description":"Breadcrumb field (always empty for compatibility)","examples":[[""]]}},"type":"object","required":["source","document","breadcrumb"],"title":"Origin","description":"The sources and documents from which the KnowBit was extracted."},"QueryRequest":{"properties":{"input":{"type":"string","title":"Input","description":"Natural language question or Dot-Notation Syntax (e.g. \"companies.industry=fintech.founded_year>=2020\"). Dot-Notation Syntax is not a strict grammar — there is no syntax to get wrong. An empty or fallback result means no match, not a syntax error.","examples":["companies.industry=fintech.founded_year>=2020"]},"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":"companies.industry=fintech.founded_year>=2020"}},"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}]}},"ReasoningSteps":{"properties":{"content":{"type":"string","title":"Content","description":"The content of the reasoning step.","examples":["Altano Energy secured a €60 million Series C round in July 2025 from Pioneer Point Partners and M&G Investments."]},"references":{"items":{"type":"string","format":"uuid"},"type":"array","title":"References","description":"The UUIDs of the KnowBits referenced in the reasoning step. Must match 'id' fields in context array.","examples":[["f22a1a96-6234-48d7-95c2-8b049f00fdab"]]}},"type":"object","required":["content","references"],"title":"ReasoningSteps","description":"A step in the reasoning process."},"SearchRequest":{"properties":{"input":{"type":"string","title":"Input","description":"Natural language question or Dot-Notation Syntax (e.g. \"companies.industry=fintech.founded_year>=2020\"). Dot-Notation Syntax is not a strict grammar — there is no syntax to get wrong. An empty or fallback result means no match, not a syntax error.","examples":["Who founded Anthropic and what is their background?"]},"explainability":{"type":"boolean","title":"Explainability","description":"Whether to generate explainability for the answer.","default":true,"examples":[true]},"return_entities":{"type":"boolean","title":"Return Entities","description":"Whether to return the entities identified in the answer.","default":true,"examples":[true]}},"type":"object","required":["input"],"title":"SearchRequest","example":{"input":"Who founded Anthropic and what is their background?"}},"Source":{"properties":{"name":{"type":"string","title":"Name","description":"The name or title of the source.","examples":["Impact Loop"]},"url":{"type":"string","minLength":1,"format":"uri","title":"URL","description":"The URL of the source.","examples":["https://www.impactloop.com/"]}},"type":"object","required":["name","url"],"title":"Source","description":"Organization that provides, creates, or publishes the document, like a web site, a book, a report, etc."}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-KEY"}}}}