---
title: "Search Entities"
method: GET
path: "/v1/entities"
tags: ["API v1", "Entities"]
---

# Search Entities

`GET /v1/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.

## Query parameters

- `name` string, required — Entity name to search for
- `entity_types` string[] — Filter by entity types
- `limit` integer — Maximum number of results

## Response `200`

Successful Response

- EntitySearchResponse — Response containing a list of entities matching the search query.
  - `entities` Entity[], required — List of entities matching the search query, ordered by relevance (most relevant first).
    - `id` string, uuid, required — The ID of the entity
    - `name` string, required — The name of the entity
    - `entity_type` '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', required — The type of the entity
    - `description` string, nullable — A short description of the entity

## Other responses

- `422` — Validation Error
- `429` — Too many requests (rate limit exceeded)

---

[API](https://skmtc.net/cala/apis/cala-ai.md) · [All operations](https://skmtc.net/cala/apis/cala-ai/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cala/cala-ai/versions/ee1ba9729aeb/schema)