Retrieve Entity
Retrieve an entity by its UUID.
Returns detailed information including legal name, industry, founders, executives, headquarters, employee count, and more.
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.
Use the Entity Introspection endpoint to see which properties and relationships can be queried for an entity.
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 the complete profile. Use entity_search first if you only have a name.
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, Person, Event, GPE, Country, CountryRegion, Industry, FinancialMetric, Group, CorporateEvent, PrivateCompanyFundingRound, Facility, Location, Organism, Plant, Product, Sanction, WorkOfArt, Law, Language, Exchange, Future, Commodity, PositioningMetric, MacroIndicatorPublication, MacroIndicator 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"
}
]