Entities
Get typed entity data by its numeric UUID — company, person, place, law, financial instrument, and more (the schema spans many domains, illustrative not exhaustive) — in two modes:
-
Coarse (no body): returns only the default property set. No relationships, no numerical observations. Use only when a rough profile is enough.
-
Projection (body): name exact
properties,relationships, andnumerical_observationsto get back. The only way to get relationships or time-series data, and the most token-efficient read. Available fields vary by entity type and must be queryable for that specific entity — runentity_introspectionfirst to discover them; projecting blind wastes round-trips and may hit empty or non-queryable edges.
Pass the entity UUID in the URL path (e.g. POST /entities/{entity_id}). Optionally send a JSON body
to specify which properties and relationships to return; if omitted, default properties are returned.
Examples (path + optional body):
POST /entities/c6772802-bdbc-4778-91e9-cd3d27d008d5
Optional body: {"properties": ["name", "aliases", "registered_address", "employee_count"], "relationships": {"outgoing": {"IS_ULTIMATE_PARENT": {"limit": 5}}, "incoming": {"IS_CEO_OF": {}}}}
Use this when: You already have an entity UUID (from entity_search, knowledge_search, or knowledge_query
results) and need entity data. Use entity_search first if you only have a name, and entity_introspection
first if you need a projection.
Authorizations
Path Parameters
Body
Optional query to specify which properties and relationships to return for the entity. If it is not provided, default properties will be returned.
List of entity property names to query
[
"name",
"aliases",
"registered_address",
"employee_count"
]Relationship queries
UUIDs of the numerical observations to query
{
"FinancialMetric": ["1d3eae40-0ba8-5baf-9907-6a4823b067bb"]
}Response
Successful Response
Response containing full entity profile
The ID of the entity
The name of the entity
The type of the entity
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 List of property names available for this entity (e.g. id, name, currency).
{
"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"
}
}Outgoing and incoming relationship types. This field is empty unless relationships.incoming and/or relationships.outgoing are provided in the request.
A short description of the entity
Numerical observations keyed by observation type.
[
{
"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"
}
]