Search Entities

curl --request GET \
  --url https://api.cala.ai/v1/entities \
  --header 'X-API-KEY: <api-key>'

import requests

url = "https://api.cala.ai/v1/entities"

headers = {"X-API-KEY": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://api.cala.ai/v1/entities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "entities": [
    {
      "description": "An American multinational technology company.",
      "entity_type": "Company",
      "id": "e5bb591a-d308-4aa5-9672-96046d366cde",
      "name": "OpenAI"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Too many requests."
}

API v1

Search Entities

Find real-world entities by name with fuzzy matching — spans many domains and keeps growing: business (companies, investors, funding rounds, M&A, industries, products), people, legal (laws, regulations, sanctions), geography (countries, places), finance/macro (financial metrics, macro indicators, FX rates), and more — treat this list as illustrative, not exhaustive. Use for “look up X” / “who/what is X” / “X’s profile, properties, or relationships” when you know (or partially know) the name. Optionally filter by entity type.

Returns an array of matching entities with IDs that feed entity_retrieval (entity data) and entity_introspection (available fields).

Examples:

{"name": "OpenAI"}

{"name": "Elon Musk", "entity_types": ["Person"]}

{"name": "Berlin", "entity_types": ["GPE"]}

{"name": "GDPR", "entity_types": ["Law"]}

Use this when: You know the name and want the entity ID or a quick profile. Use knowledge_query instead for attribute-based filtering without a name.

GET

entities

Search Entities

curl --request GET \
  --url https://api.cala.ai/v1/entities \
  --header 'X-API-KEY: <api-key>'

import requests

url = "https://api.cala.ai/v1/entities"

headers = {"X-API-KEY": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://api.cala.ai/v1/entities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "entities": [
    {
      "description": "An American multinational technology company.",
      "entity_type": "Company",
      "id": "e5bb591a-d308-4aa5-9672-96046d366cde",
      "name": "OpenAI"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Too many requests."
}

Authorizations

X-API-KEY

string

header

required

Query Parameters

name

string

required

Entity name to search for

Minimum string length: 1

entity_types

enum<string>[]

Filter by entity types

Available options:

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

limit

integer

default:20

Maximum number of results

Required range: 1 <= x <= 100

Response

Successful Response

Response containing a list of entities matching the search query.

entities

Entity · object[]

required

List of entities matching the search query, ordered by relevance (most relevant first).

Show child attributes

Query Entity Introspection