curl --request POST \
--url https://api.cala.ai/v1/entities/lookup \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"id": {
"lei": "95980020140005017502"
}
}
'import requests
url = "https://api.cala.ai/v1/entities/lookup"
payload = { "id": { "lei": "95980020140005017502" } }
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({id: {lei: '95980020140005017502'}})
};
fetch('https://api.cala.ai/v1/entities/lookup', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "d1715183-1d00-42c9-81c3-be3da24cdcf2",
"name": "MANGO MNG S.A.",
"entity_type": "Company",
"description": "Spanish fashion retailer headquartered in Palau-solità i Plegamans, Barcelona, founded in 1989."
}{
"error": {
"error_type": "internal_server_error",
"message": "<string>"
},
"response_type": "ERROR"
}{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded. Too many requests."
}Lookup Entity
Resolve one entity by an external identifier.
Accepts exactly one of these schemes: lei (Legal Entity Identifier), cik (SEC Central Index Key), rssd_id (Federal Reserve RSSD ID), companies_house_uk_company_number (UK Companies House number), siren (French SIREN).
Pass exactly one scheme in id, or as a top-level shorthand:
{"id": {"lei": "95980020140005017502"}}
{"lei": "95980020140005017502"}
Returns an entity stub (id, name, entity_type, description). Feed the id into Retrieve Entity / Entity Introspection for a full profile.
Use this when you have an external identifier and need the entity UUID. Use retrieve_entity when you already have the UUID.
curl --request POST \
--url https://api.cala.ai/v1/entities/lookup \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"id": {
"lei": "95980020140005017502"
}
}
'import requests
url = "https://api.cala.ai/v1/entities/lookup"
payload = { "id": { "lei": "95980020140005017502" } }
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({id: {lei: '95980020140005017502'}})
};
fetch('https://api.cala.ai/v1/entities/lookup', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "d1715183-1d00-42c9-81c3-be3da24cdcf2",
"name": "MANGO MNG S.A.",
"entity_type": "Company",
"description": "Spanish fashion retailer headquartered in Palau-solità i Plegamans, Barcelona, founded in 1989."
}{
"error": {
"error_type": "internal_server_error",
"message": "<string>"
},
"response_type": "ERROR"
}{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded. Too many requests."
}Body
Resolve one Entity by an Ontology identifier scheme.
id is a single-key object { "<scheme>": "<value>" } (e.g. {"lei": "5493…"}).
A top-level shorthand {"lei": "5493…"} is accepted and normalised into id.
Integer values are coerced to strings (e.g. {"cik": 320193}).
Response
Entity stub matching Entity Search
The type of the entity
Entity, Animal, Award, Organization, Company, EducationalInstitution, ResearchInstitution, GovernmentalInstitution, CulturalInstitution, NonprofitOrganization, IntergovernmentalOrganization, HealthcareEstablishment, Hospital, HealthcareNetwork, HealthcareMetric, Person, Event, GPE, Country, CountrySubdivision, DependentTerritory, Municipality, Continent, Currency, Industry, DomainName, FinancialMetric, CuratedFinancialMetric, Group, CorporateEvent, PrivateCompanyFundingRound, FundingRound, FundingRoundTranche, LoanFacilityComponent, Facility, Location, Organism, Plant, Fungus, Bacterium, Archaeon, Virus, Protist, Chromosome, Product, Medicine, ChemicalSubstance, SmallMolecule, Protein, ProteinComplex, Antibody, ProteinIsoform, Gene, Transcript, Oligonucleotide, Drug, SmallMoleculeDrug, AntibodyDrug, ProteinDrug, OligonucleotideDrug, ChemicalSubstanceDrug, CellTherapy, GeneTherapy, MechanismOfAction, Disease, Anatomy, Pathway, ClinicalTrial, ClinicalTrialArm, ClinicalIntervention, ClinicalOutcome, Sanction, WorkOfArt, Document, Patent, ResearchPaper, Law, Language, Exchange, Future, Commodity, PositioningMetric, MacroIndicatorPublication, MacroIndicator, ForeignExchangeRate, CountryRegion, AbstractFinancialMetric "Company"