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": [
      "a277a751-96fd-5204-b7bc-2238a7cc4188"
    ]
  },
  "properties": [
    "name",
    "aliases",
    "registered_address",
    "employee_count"
  ],
  "relationships": {
    "incoming": {
      "IS_BOARD_MEMBER_OF": {
        "limit": 2,
        "offset": 2
      }
    },
    "outgoing": {
      "IS_REGISTERED_IN": {},
      "IS_ULTIMATE_PARENT": {
        "limit": 2,
        "offset": 0
      }
    }
  }
}
'
{
  "entity_type": "Company",
  "id": "9af54183-a1c6-468c-b608-e96ddb80366d",
  "name": "Apple Inc",
  "numerical_observations": [],
  "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."
      ]
    },
    "registered_address": {
      "sources": [
        {
          "date": "2026-02-26",
          "document": {
            "endpoint": "https://api.gleif.org/api/v1/lei-records?filter%5Bentity.legalName%5D=APPLE+INC&page%5Bsize%5D=20",
            "params": {},
            "response_hash": "7089723cc94015908b284e2637d34fca0d700bccca36b0f83e4fb6e93c211437"
          },
          "name": "GLEIF"
        }
      ],
      "value": "C/O C T Corporation System, 330 N. Brand Blvd, Suite 700, Glendale, US-CA, 91203, US"
    },
    "employee_count": {
      "sources": [
        {
          "date": "2026-03-01",
          "document": "https://www.macrotrends.net/stocks/charts/AAPL/apple/number-of-employees",
          "name": "Macrotrends | The Long Term Perspective on Markets"
        }
      ],
      "value": 164000
    }
  },
  "relationships": {
    "incoming": {
      "IS_BOARD_MEMBER_OF": [
        {
          "entity_type": "Person",
          "id": "7e01020c-cd58-468c-8b2b-d6d1de1ba7bd",
          "name": "Andrea Jung",
          "properties": {
            "target_id": "c6772802-bdbc-4778-91e9-cd3d27d008d5",
            "source_id": "7e01020c-cd58-468c-8b2b-d6d1de1ba7bd",
            "valid_since": "2008-01-04"
          }
        },
        {
          "entity_type": "Person",
          "id": "9ca4e4fd-f26b-42f4-b8f8-d1cf2f698c0a",
          "name": "Steve Jobs",
          "properties": {
            "valid_until": "2012-02-27",
            "target_id": "c6772802-bdbc-4778-91e9-cd3d27d008d5",
            "source_id": "9ca4e4fd-f26b-42f4-b8f8-d1cf2f698c0a",
            "valid_since": "2011-02-23"
          }
        }
      ]
    },
    "outgoing": {
      "IS_REGISTERED_IN": [
        {
          "entity_type": "CountryRegion",
          "id": "8f206f1e-9e92-47be-ac44-8f446bd50857",
          "name": "California",
          "properties": {
            "target_id": "8f206f1e-9e92-47be-ac44-8f446bd50857",
            "source_id": "c6772802-bdbc-4778-91e9-cd3d27d008d5"
          }
        }
      ]
    }
  }
}

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": ["a277a751-96fd-5204-b7bc-2238a7cc4188"]
}

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,
Organization,
Company,
EducationalInstitution,
Person,
GPE,
Country,
CountryRegion,
Industry,
FinancialMetric,
CorporateEvent,
Facility,
Location,
Product,
WorkOfArt,
Law,
Language
​
properties
Properties · object
required

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

Example:
{
  "aliases": {
    "sources": [],
    "value": ["Apple Computer, Inc."]
  },
  "employee_count": {
    "sources": [
      {
        "date": "2026-03-01",
        "document": "https://www.macrotrends.net/stocks/charts/AAPL/apple/number-of-employees",
        "name": "Macrotrends | The Long Term Perspective on Markets"
      }
    ],
    "value": 164000
  },
  "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-02-26",
        "document": {
          "endpoint": "https://api.gleif.org/api/v1/lei-records?filter%5Bentity.legalName%5D=APPLE+INC&page%5Bsize%5D=20",
          "params": {},
          "response_hash": "7089723cc94015908b284e2637d34fca0d700bccca36b0f83e4fb6e93c211437"
        },
        "name": "GLEIF"
      }
    ],
    "value": "C/O C T Corporation System, 330 N. Brand Blvd, Suite 700, Glendale, US-CA, 91203, US"
  }
}
​
relationships
EntityRelationships · object
required

Outgoing and incoming relationship types.

​
numerical_observations
any[]

Numerical observations keyed by observation type.

Example:
[]