Entity Resolution
Poll a resolution job
GET
/v3/jobs/{job_id} Returns 202 while the job is running and 200 once it finishes. Read-only: polling
never starts or repeats work.
Accepts either the job_id or the request_id from the kickoff.
Path parameters
job_idstring requiredThejob_idor thereqa_request_idreturned by the kickoff.
Query parameters
includestring (enum)basisSet tobasisto receive the provenance plane. Required here to get it in the body, and it only works if the kickoff also asked forbasis. Provenance is stored with the result, so polling never re-runs research to produce it.
Responses
200 The job finished. A failed resolution is also a `200`, so check `status`.
statusstring (enum)matchedpartial_matchinconclusiveno_matchnot_foundmergedfailedmatch_confidenceintegerHow certain we are this is the entity you asked for.typestring (enum)businessnonprofitgovernmentpersonotherunknownsubtypestring (enum)Show 9 possible valuesHide possible values
incorporated_entityunincorporated_entitynonprofit_entitygovernment_entitynatural_personcomplex_business_structuretrading_name_onlyother_entityunknownentityobjectShow 13 nested fieldsHide nested fields
idstringdisplay_namestringThe brand or common name.legal_namestringThe registered name, as it appears on the government record.statusstring (enum)activeinactivedescriptionstringwebsitestringheadquartersobjectThe headquarters address, always as the nestedaddressobject — there are no flat alias fields. Every key below is always present; unknown values arenullrather than omitted, so the key set is stable across responses and endpoints.Show 1 nested fieldHide nested fields
addressobjectShow 10 nested fieldsHide nested fields
street_addressstringstreet_numberstringsub_premisestringcitystringstatestringSubdivision as written ("California"), when we hold it.state_codestringISO-3166-2 subdivision code ("CA"). Derived fromstatewhen we can map it confidently;nullrather than guessed when we cannot.postal_codestringcountrystringcountry_codestringformatted_addressstringSingle-line rendering of the parts above. Composed from them when we hold no stored formatting.
primary_legal_entityobjectThe government registration that anchors this entity.Show 5 nested fieldsHide nested fields
idstringjurisdictionstringcountry_codestringstate_codestringregistration_authorityobjectThe government register this entity is recorded in.Show 7 nested fieldsHide nested fields
idintegercodestringnamestringorganizationstringjurisdictionstringcountry_codestringwebsitestring
identifiersarray<object>Typed external identifiers, in a stable order.Show 3 nested fieldsHide nested fields
typestring (enum)registration_idciksec_cikleibiceindunstickervaluestringCanonicalized for its type on the resolution and record endpoints. See Codes & enums.jurisdictionstringISO jurisdiction, where the identifier type is jurisdictional. Absent entirely on/v3/domain-intelligence.
matching_branchobjectSet when the query matched a specific branch or foreign registration rather than the entity's home registration.facetsobjectOwnership and legal form, not industry. Industry codes live underindustry.schemes.Show 2 nested fieldsHide nested fields
sectorstring (enum)privatepublicgovernmentnonprofitlegal_formstring (enum)Show 16 possible valuesHide possible values
llccorporationc_corps_corplpllpgpsole_proprietorshipnonprofit_corppllcpccooperativemunicipal_agencygovernment_entitytrustunknown
industryobjectIndustry codes keyed by scheme. A scheme that was not classified is absent; an empty key is never returned.Show 1 nested fieldHide nested fields
schemesobjectShow 2 nested fieldsHide nested fields
naics_2022array<object>Show 4 nested fieldsHide nested fields
codestringlabelstringis_primarybooleanOne code per scheme is primary. Primary codes are returned first.confidenceinteger
sicarray<object>Show 4 nested fieldsHide nested fields
codestringlabelstringis_primarybooleanOne code per scheme is primary. Primary codes are returned first.confidenceinteger
parent_entityobjectShow 1 nested fieldHide nested fields
namestring
candidateobjectOur best hypothesis when an entity could not be confirmed. A response populatesentityorcandidate, never both.Show 6 nested fieldsHide nested fields
namestringlegal_namestringjurisdictionstringstatusstringdescriptionstringprimary_addressobjectShow 3 nested fieldsHide nested fields
full_addressstringstate_codestringcountry_codestring
factorsarray<object>Show 4 nested fieldsHide nested fields
codestringStable code. See Codes & enums.typestring (enum)strengthlimitationdescriptionstringimpactstring
actionsarray<object>Show 2 nested fieldsHide nested fields
codestringdescriptionstring
merged_intostringSet whenstatusismerged. The canonical entity ID to store instead.basisarray<object>Present only when the request was made withinclude=basis.Show 4 nested fieldsHide nested fields
fieldstringDot-path intoentity, for examplelegal_name,facets.sector,primary_legal_entity.jurisdiction, oridentifiers.0.value.confidencestring (enum)highmediumlowreasoningstringcitationsarray<object>Show 4 nested fieldsHide nested fields
urlstringexcerptstringsource_typestring (enum)government_registrycompany_websitepublic_profilewebauthority_tierinteger (enum)1231 government registry, 2 public profile, 3 company website or general web.
request_idstringmetadataobjectShow 5 nested fieldsHide nested fields
queryobjectThe query as we interpreted it.Show 5 nested fieldsHide nested fields
namestringlocationstringcontextstringclassificationstringHow we judged the query itself, for exampleambiguouswhen the name alone could match several companies. Useful for deciding whether to retry with morecontext.modestringInternal echo. Alwaysstandardon/v3; carried for parity with older surfaces. Do not branch on it.
resolved_atstring <date-time>When this resolution ran.updated_atstring <date-time>When the underlying record was last updated.from_cachebooleanWhether the response came from the response cache.cache_hit_typestringWhich cache served the response, ornullwhen none did.
202 Still running. Poll again.
statusstring (enum)pendingjob_idstringJob identifier, accepted byGET /v3/jobs/{job_id}.request_idstringThereqa_form of the same job. Also accepted byGET /v3/jobs/{job_id}, and useful as a correlation ID in support requests.
400 Invalid or missing parameters.
errorobjectShow 2 nested fieldsHide nested fields
typestringStable, machine-readable error code.messagestringHuman-readable explanation. Do not match on this.
401 Missing or invalid API key.
errorobjectShow 2 nested fieldsHide nested fields
typestringStable, machine-readable error code.messagestringHuman-readable explanation. Do not match on this.
404 Unknown job ID, or a job belonging to another account.
errorobjectShow 2 nested fieldsHide nested fields
typestringStable, machine-readable error code.messagestringHuman-readable explanation. Do not match on this.
429 Rate limit exceeded.
errorobjectShow 2 nested fieldsHide nested fields
typestringStable, machine-readable error code.messagestringHuman-readable explanation. Do not match on this.
500 Something went wrong on our side.
errorobjectShow 2 nested fieldsHide nested fields
typestringStable, machine-readable error code.messagestringHuman-readable explanation. Do not match on this.
Example request
cURL
curl --request GET \
--url 'https://api.savvyiq.ai/v3/jobs/019fe975-186e-707c-b59a-b0a6c9914221' \
--header 'apikey: YOUR_API_KEY' Example response
Datadog resolved by name and location, with include=basis200
{
"type": "business",
"basis": [
{
"field": "description",
"citations": [
{
"url": "https://www.linkedin.com/company/datadog",
"excerpt": "Datadog is the essential monitoring platform for cloud applications. We bring together data from servers, containers, databases, and third-party services to make your stack entirely observable. These capabilities help DevOps teams avoid downtime, resolve performance issues, and ensure customers are getting the best user experience.",
"source_type": "public_profile",
"authority_tier": 2
},
{
"url": "https://datadoghq.com",
"excerpt": "Datadog, Inc. provides software solutions. The Company offers cloud-based monitoring and analytics platform which integrates and automates infrastructure monitoring, application performance monitoring, and log management for real-time observability of customers. Datadog operates worldwide.",
"source_type": "public_profile",
"authority_tier": 2
},
{
"url": "https://www.crunchbase.com/organization/datadog",
"excerpt": "Datadog is an observability and security platform that offers infrastructure, applications, software development, and monitoring services. It brings together data from servers, containers, databases, and third-party services to make your stack entirely observable. These capabilities help DevOps teams avoid downtime, resolve performance issues, and ensure customers are getting the best user experience.",
"source_type": "public_profile",
"authority_tier": 2
},
{
"url": "https://en.wikipedia.org/wiki/Datadog",
"excerpt": "Datadog, Inc. is an American company that provides an observability service for cloud-scale applications, providing monitoring of servers, databases, tools, ...",
"source_type": "web",
"authority_tier": 3
},
{
"url": "kg:Datadog",
"excerpt": "Software company",
"source_type": "web",
"authority_tier": 3
},
{
"url": "sec-registrant:1561550",
"excerpt": "SEC EDGAR: \"Datadog, Inc.\" is the registered public-company name (CIK 1561550, ticker DDOG), incorporated in NV, USA. If resolving this registrant, the legal identity and home jurisdiction above are authoritative; a same-name registration in another state is a different entity unless it is this company's own filing.",
"source_type": "web",
"authority_tier": 3
}
],
"reasoning": "Corroborated by the cited public sources below.",
"confidence": "high"
},
{
"field": "facets.legal_form",
"citations": [
{
"url": "https://corp.delaware.gov/",
"excerpt": "DATADOG, INC. — Delaware registration 4832851, status ACTIVE",
"source_type": "government_registry",
"authority_tier": 1
}
],
"reasoning": "Mapped from the resolved entity's legal-structure classification.",
"confidence": "high"
},
{
"field": "facets.sector",
"citations": [],
"reasoning": "Public: a public-markets identifier (CIK / ticker) is present on the resolved entity.",
"confidence": "medium"
},
{
"field": "identifiers.0.value",
"citations": [
{
"url": "https://corp.delaware.gov/",
"excerpt": "DATADOG, INC. — Delaware registration 4832851, status ACTIVE",
"source_type": "government_registry",
"authority_tier": 1
}
],
"reasoning": "Registration number from the matched government registry record.",
"confidence": "high"
},
{
"field": "industry",
"citations": [
{
"url": "https://www.linkedin.com/company/datadog",
"excerpt": "Datadog is the essential monitoring platform for cloud applications. We bring together data from servers, containers, databases, and third-party services to make your stack entirely observable. These capabilities help DevOps teams avoid downtime, resolve performance issues, and ensure customers are getting the best user experience.",
"source_type": "public_profile",
"authority_tier": 2
},
{
"url": "https://datadoghq.com",
"excerpt": "Datadog, Inc. provides software solutions. The Company offers cloud-based monitoring and analytics platform which integrates and automates infrastructure monitoring, application performance monitoring, and log management for real-time observability of customers. Datadog operates worldwide.",
"source_type": "public_profile",
"authority_tier": 2
},
{
"url": "https://www.crunchbase.com/organization/datadog",
"excerpt": "Datadog is an observability and security platform that offers infrastructure, applications, software development, and monitoring services. It brings together data from servers, containers, databases, and third-party services to make your stack entirely observable. These capabilities help DevOps teams avoid downtime, resolve performance issues, and ensure customers are getting the best user experience.",
"source_type": "public_profile",
"authority_tier": 2
},
{
"url": "https://en.wikipedia.org/wiki/Datadog",
"excerpt": "Datadog, Inc. is an American company that provides an observability service for cloud-scale applications, providing monitoring of servers, databases, tools, ...",
"source_type": "web",
"authority_tier": 3
},
{
"url": "kg:Datadog",
"excerpt": "Software company",
"source_type": "web",
"authority_tier": 3
},
{
"url": "sec-registrant:1561550",
"excerpt": "SEC EDGAR: \"Datadog, Inc.\" is the registered public-company name (CIK 1561550, ticker DDOG), incorporated in NV, USA. If resolving this registrant, the legal identity and home jurisdiction above are authoritative; a same-name registration in another state is a different entity unless it is this company's own filing.",
"source_type": "web",
"authority_tier": 3
}
],
"reasoning": "Industry classification: NAICS from the cited business activity; SIC (when present) derived from NAICS via crosswalk.",
"confidence": "medium"
},
{
"field": "legal_name",
"citations": [
{
"url": "https://corp.delaware.gov/",
"excerpt": "DATADOG, INC. — Delaware registration 4832851, status ACTIVE",
"source_type": "government_registry",
"authority_tier": 1
},
{
"url": "https://datadoghq.com",
"excerpt": "Datadog, Inc. provides software solutions. The Company offers cloud-based monitoring and analytics platform which integrates and automates infrastructure monitoring, application performance monitoring, and log management for real-time observability of customers. Datadog operates worldwide.",
"source_type": "public_profile",
"authority_tier": 2
},
{
"url": "https://en.wikipedia.org/wiki/Datadog",
"excerpt": "Datadog, Inc. is an American company that provides an observability service for cloud-scale applications, providing monitoring of servers, databases, tools, ...",
"source_type": "web",
"authority_tier": 3
},
{
"url": "sec-registrant:1561550",
"excerpt": "SEC EDGAR: \"Datadog, Inc.\" is the registered public-company name (CIK 1561550, ticker DDOG), incorporated in NV, USA. If resolving this registrant, the legal identity and home jurisdiction above are authoritative; a same-name registration in another state is a different entity unless it is this company's own filing.",
"source_type": "web",
"authority_tier": 3
}
],
"reasoning": "Government records provide a clear legal name and jurisdiction. Multiple web sources corroborate the legal name and provide detailed business activity descriptions. The primary legal name 'DATADOG, INC.' is consistently found in authoritative government records with active status. Delaware is identified as the formation jurisdiction in multiple sources. While some SEC filings mention NV, Delaware is more consistently cited as the primary incorporation state in the provided government records. The business activity is well-described across multiple high-confidence web sources. The presence of a branch in Massachusetts is noted.",
"confidence": "high"
},
{
"field": "primary_legal_entity.jurisdiction",
"citations": [
{
"url": "https://corp.delaware.gov/",
"excerpt": "DATADOG, INC. — Delaware registration 4832851, status ACTIVE",
"source_type": "government_registry",
"authority_tier": 1
}
],
"reasoning": "Formation jurisdiction from the matched government registry record.",
"confidence": "high"
},
{
"field": "status",
"citations": [
{
"url": "https://corp.delaware.gov/",
"excerpt": "DATADOG, INC. — Delaware registration 4832851, status ACTIVE",
"source_type": "government_registry",
"authority_tier": 1
}
],
"reasoning": "Status taken from the matched government registry record.",
"confidence": "high"
}
],
"entity": {
"id": "siq_33d67jj0wJESjEdFHMhuQ",
"facets": {
"sector": "public",
"legal_form": "corporation"
},
"status": "active",
"website": "https://www.datadoghq.com/",
"industry": {
"schemes": {
"sic": [
{
"code": "7372",
"label": "Prepackaged Software",
"confidence": 95,
"is_primary": true
}
],
"naics_2022": [
{
"code": "513210",
"label": "Software Publishers",
"confidence": 95,
"is_primary": true
},
{
"code": "541511",
"label": "Custom Computer Programming Services",
"confidence": 80,
"is_primary": false
},
{
"code": "51",
"label": "Information",
"confidence": 90,
"is_primary": false
}
]
}
},
"legal_name": "DATADOG, INC.",
"description": "Datadog is a leading cloud monitoring and security platform that provides AI-powered observability solutions for cloud-scale applications. Its SaaS-based data analytics platform enables businesses to gain comprehensive visibility into their entire technology stack, from infrastructure to applications, helping DevOps teams prevent downtime, resolve performance issues, and ensure optimal user experience.",
"identifiers": [
{
"type": "registration_id",
"value": "4832851",
"jurisdiction": "US-DE"
},
{
"type": "cik",
"value": "0001561550",
"jurisdiction": null
},
{
"type": "lei",
"value": "549300F6JNO0KRPO1K63",
"jurisdiction": null
}
],
"display_name": "Datadog",
"headquarters": {
"address": {
"street_address": "620 8th Ave, 45th Floor",
"street_number": null,
"sub_premise": null,
"city": "New York",
"state": "New York",
"state_code": "NY",
"postal_code": "10018",
"country": "United States",
"country_code": "US",
"formatted_address": "620 8th Ave, 45th Floor, New York, New York 10018, United States"
}
},
"matching_branch": null,
"primary_legal_entity": {
"id": "le_2Zp3Yy6S7O6Btccq56WOH",
"state_code": "DE",
"country_code": "US",
"jurisdiction": "US-DE",
"registration_authority": {
"id": 1024,
"code": "RA000602",
"name": "Division of Corporations, Department of State",
"website": "https://corp.delaware.gov/",
"country_code": "US",
"jurisdiction": "Delaware",
"organization": "Division of Corporations, Department of State"
}
}
},
"status": "matched",
"actions": [],
"factors": [
{
"code": "name_exact_match",
"type": "strength",
"impact": "Strong identifier for the correct entity.",
"description": "The name 'Datadog' provided in the query exactly matches the entity's common name."
},
{
"code": "headquarters_match",
"type": "strength",
"impact": "Confirms this is the primary legal entity location.",
"description": "The requested location 'New York, NY' precisely matches the entity's registered headquarters."
},
{
"code": "legal_entity_confirmed",
"type": "strength",
"impact": "Confirms a valid legal entity through official sources.",
"description": "This has been definitively confirmed as the primary legal entity through official registration sources."
},
{
"code": "registry_identifier_anchored",
"type": "strength",
"impact": "Safe to use for deterministic record matching and deduplication.",
"description": "The match is anchored by a stable government registry identifier."
}
],
"subtype": "incorporated_entity",
"metadata": {
"query": {
"mode": "standard",
"name": "Datadog",
"context": null,
"location": "New York, NY",
"classification": "specific"
},
"from_cache": true,
"updated_at": "2026-07-31T19:22:05.042Z",
"cache_hit_type": "exact"
},
"candidate": null,
"request_id": "reqa_344tSxhAVACWbuENINJ9D",
"match_confidence": 100
}