CAcala
API v1
Entities

Search Entities

Changed on

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), healthcare (hospitals, healthcare establishments and metrics), 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/v1/entities

Request

  • Base URL
    https://api.cala.ai
  • Auth
    API key in header X-API-KEY

Query parameters

namestring required

Entity name to search for

Example:Fracttal
entity_typesstring[]

Filter by entity types

limitinteger

Maximum number of results

Response

Successful Response

Example response

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

Changes

  • e1f2f3a871c8Revision changes
    • warning

      added the new CuratedFinancialMetric enum value to the // response property for the response status

    • info

      added the enum value CuratedFinancialMetric to the property items/ of the query request parameter entity_types

  • 09e738aec7f1Revision changes
    • warning

      for the query request parameter name, the maxLength was set to 100

    • warning

      removed the optional property from the response with the status

    • warning

      added the new AbstractFinancialMetric enum value to the // response property for the response status

    • warning

      added the new Anatomy enum value to the // response property for the response status

    • warning

      added the new Antibody enum value to the // response property for the response status

    • warning

      added the new AntibodyDrug enum value to the // response property for the response status

    • warning

      added the new Archaeon enum value to the // response property for the response status

    • warning

      added the new Bacterium enum value to the // response property for the response status

    • warning

      added the new CellTherapy enum value to the // response property for the response status

    • warning

      added the new ChemicalSubstance enum value to the // response property for the response status

    • warning

      added the new ChemicalSubstanceDrug enum value to the // response property for the response status

    • warning

      added the new Chromosome enum value to the // response property for the response status

    • warning

      added the new ClinicalIntervention enum value to the // response property for the response status

    • warning

      added the new ClinicalOutcome enum value to the // response property for the response status

    • warning

      added the new ClinicalTrial enum value to the // response property for the response status

    • warning

      added the new ClinicalTrialArm enum value to the // response property for the response status

    • warning

      added the new CulturalInstitution enum value to the // response property for the response status

    • warning

      added the new Disease enum value to the // response property for the response status

    • warning

      added the new Document enum value to the // response property for the response status

    • warning

      added the new DomainName enum value to the // response property for the response status

    • warning

      added the new Drug enum value to the // response property for the response status

    • warning

      added the new FundingRound enum value to the // response property for the response status

    • warning

      added the new FundingRoundTranche enum value to the // response property for the response status

    • warning

      added the new Fungus enum value to the // response property for the response status

    • warning

      added the new Gene enum value to the // response property for the response status

    • warning

      added the new GeneTherapy enum value to the // response property for the response status

    • warning

      added the new GovernmentalInstitution enum value to the // response property for the response status

    • warning

      added the new HealthcareEstablishment enum value to the // response property for the response status

    • warning

      added the new HealthcareMetric enum value to the // response property for the response status

    • warning

      added the new HealthcareNetwork enum value to the // response property for the response status

    • warning

      added the new Hospital enum value to the // response property for the response status

    • warning

      added the new LoanFacilityComponent enum value to the // response property for the response status

    • warning

      added the new MechanismOfAction enum value to the // response property for the response status

    • warning

      added the new Medicine enum value to the // response property for the response status

    • warning

      added the new NonprofitOrganization enum value to the // response property for the response status

    • warning

      added the new Oligonucleotide enum value to the // response property for the response status

    • warning

      added the new OligonucleotideDrug enum value to the // response property for the response status

    • warning

      added the new Patent enum value to the // response property for the response status

    • warning

      added the new Pathway enum value to the // response property for the response status

    • warning

      added the new Protein enum value to the // response property for the response status

    • warning

      added the new ProteinComplex enum value to the // response property for the response status

    • warning

      added the new ProteinDrug enum value to the // response property for the response status

    • warning

      added the new ProteinIsoform enum value to the // response property for the response status

    • warning

      added the new Protist enum value to the // response property for the response status

    • warning

      added the new ResearchInstitution enum value to the // response property for the response status

    • warning

      added the new ResearchPaper enum value to the // response property for the response status

    • warning

      added the new SmallMolecule enum value to the // response property for the response status

    • warning

      added the new SmallMoleculeDrug enum value to the // response property for the response status

    • warning

      added the new Transcript enum value to the // response property for the response status

    • warning

      added the new Virus enum value to the // response property for the response status

    • info

      added the enum value AbstractFinancialMetric to the property items/ of the query request parameter entity_types

    • info

      added the enum value Anatomy to the property items/ of the query request parameter entity_types

    • info

      added the enum value Antibody to the property items/ of the query request parameter entity_types

    • info

      added the enum value AntibodyDrug to the property items/ of the query request parameter entity_types

    • info

      added the enum value Archaeon to the property items/ of the query request parameter entity_types

    • info

      added the enum value Bacterium to the property items/ of the query request parameter entity_types

    • info

      added the enum value CellTherapy to the property items/ of the query request parameter entity_types

    • info

      added the enum value ChemicalSubstance to the property items/ of the query request parameter entity_types

    • info

      added the enum value ChemicalSubstanceDrug to the property items/ of the query request parameter entity_types

    • info

      added the enum value Chromosome to the property items/ of the query request parameter entity_types

    • info

      added the enum value ClinicalIntervention to the property items/ of the query request parameter entity_types

    • info

      added the enum value ClinicalOutcome to the property items/ of the query request parameter entity_types

    • info

      added the enum value ClinicalTrial to the property items/ of the query request parameter entity_types

    • info

      added the enum value ClinicalTrialArm to the property items/ of the query request parameter entity_types

    • info

      added the enum value CulturalInstitution to the property items/ of the query request parameter entity_types

    • info

      added the enum value Disease to the property items/ of the query request parameter entity_types

    • info

      added the enum value Document to the property items/ of the query request parameter entity_types

    • info

      added the enum value DomainName to the property items/ of the query request parameter entity_types

    • info

      added the enum value Drug to the property items/ of the query request parameter entity_types

    • info

      added the enum value FundingRound to the property items/ of the query request parameter entity_types

    • info

      added the enum value FundingRoundTranche to the property items/ of the query request parameter entity_types

    • info

      added the enum value Fungus to the property items/ of the query request parameter entity_types

    • info

      added the enum value Gene to the property items/ of the query request parameter entity_types

    • info

      added the enum value GeneTherapy to the property items/ of the query request parameter entity_types

    • info

      added the enum value GovernmentalInstitution to the property items/ of the query request parameter entity_types

    • info

      added the enum value HealthcareEstablishment to the property items/ of the query request parameter entity_types

    • info

      added the enum value HealthcareMetric to the property items/ of the query request parameter entity_types

    • info

      added the enum value HealthcareNetwork to the property items/ of the query request parameter entity_types

    • info

      added the enum value Hospital to the property items/ of the query request parameter entity_types

    • info

      added the enum value LoanFacilityComponent to the property items/ of the query request parameter entity_types

    • info

      added the enum value MechanismOfAction to the property items/ of the query request parameter entity_types

    • info

      added the enum value Medicine to the property items/ of the query request parameter entity_types

    • info

      added the enum value NonprofitOrganization to the property items/ of the query request parameter entity_types

    • info

      added the enum value Oligonucleotide to the property items/ of the query request parameter entity_types

    • info

      added the enum value OligonucleotideDrug to the property items/ of the query request parameter entity_types

    • info

      added the enum value Patent to the property items/ of the query request parameter entity_types

    • info

      added the enum value Pathway to the property items/ of the query request parameter entity_types

    • info

      added the enum value Protein to the property items/ of the query request parameter entity_types

    • info

      added the enum value ProteinComplex to the property items/ of the query request parameter entity_types

    • info

      added the enum value ProteinDrug to the property items/ of the query request parameter entity_types

    • info

      added the enum value ProteinIsoform to the property items/ of the query request parameter entity_types

    • info

      added the enum value Protist to the property items/ of the query request parameter entity_types

    • info

      added the enum value ResearchInstitution to the property items/ of the query request parameter entity_types

    • info

      added the enum value ResearchPaper to the property items/ of the query request parameter entity_types

    • info

      added the enum value SmallMolecule to the property items/ of the query request parameter entity_types

    • info

      added the enum value SmallMoleculeDrug to the property items/ of the query request parameter entity_types

    • info

      added the enum value Transcript to the property items/ of the query request parameter entity_types

    • info

      added the enum value Virus to the property items/ of the query request parameter entity_types

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status