Skip to main content
POST
/
v1
/
entities
/
{entity_id}
Entities
curl --request POST \
  --url https://api.cala.ai/v1/entities/{entity_id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "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
      }
    }
  }
}
'
{
  "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
        },
        {
          "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
        },
        {
          "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
        }
      ],
      "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"
          }
        }
      ]
    }
  }
}

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.

Authorizations

​
X-API-KEY
string
header
required

Path Parameters

​
entity_id
string<uuid>
required

Body

application/json

Optional query to specify which properties and relationships to return for the entity. If it is not provided, default properties will be returned.

​
properties
string[]

List of entity property names to query

Example:
[
  "name",
  "aliases",
  "registered_address",
  "employee_count"
]
​
relationships
EntityQueryRelationships · object

Relationship queries

​
numerical_observations
Numerical Observations · object

UUIDs of the numerical observations to query

Example:
{
  "FinancialMetric": ["1d3eae40-0ba8-5baf-9907-6a4823b067bb"]
}

Response

Successful Response

Response containing full entity profile

​
id
string<uuid>
required

The ID of the entity

​
name
string
required

The name of the entity

​
entity_type
enum<string>
required

The type of the entity

Available options:
Entity,
Animal,
Award,
Organization,
Company,
EducationalInstitution,
Person,
Event,
GPE,
Country,
CountryRegion,
Industry,
FinancialMetric,
Group,
CorporateEvent,
Facility,
Location,
Organism,
Plant,
Product,
Sanction,
WorkOfArt,
Law,
Language,
Exchange
​
properties
Properties · object
required

List of property names available for this entity (e.g. id, name, currency).

Example:
{
  "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
EntityRelationships · object
required

Outgoing and incoming relationship types. This field is empty unless relationships.incoming and/or relationships.outgoing are provided in the request.

​
description
string | null

A short description of the entity

​
numerical_observations
any[]

Numerical observations keyed by observation type.

Example:
[
  {
    "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
      },
      {
        "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
      },
      {
        "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
      }
    ],
    "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"
  }
]