> For the complete documentation index, see [llms.txt](https://help.delpha.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.delpha.io/delpha-api-and-mcp/api/company.md).

# Company

Search Delpha's company datalake to power account creation and CRM enrichment.

A single **synchronous** `GET /v1/company` call — pass at least one identifier (**account name**, **legal ID**, or a unified **search string**) as a query parameter and receive matching company records inline, with no job\_id polling.

* **Disambiguation:** Optional context such as website, city, country, and known aliases sharpens matching when several companies share a similar name.
* **Control:** Tune results with fuzzy matching, a configurable result count, and a minimum score threshold.
* **Output:** Ranked, typed company records (legal ids, address, firmographics, parent hierarchy) ready to seed new CRM accounts or enrich existing ones.

Ideal for account creation flows, lead-to-account matching, and keeping your account base clean and de-duplicated.

## Search Delpha's datalake for company records

> Synchronous company search: query Delpha's company datalake and receive matching records in a single request (no job\_id polling). At least one of \`account\_name\`, \`legal\_id\`, or \`search\_str\` must be provided; optional parameters (website, city, country, aliases, fuzzy/scoring) refine and disambiguate the results.

```json
{"openapi":"3.1.0","info":{"title":"Delpha Data Quality API","version":"1.0.0"},"tags":[{"name":"Company","description":"Search Delpha's company datalake to power account creation and CRM enrichment.\n\nA single **synchronous** `GET /v1/company` call — pass at least one identifier (**account name**, **legal ID**, or a unified **search string**) as a query parameter and receive matching company records inline, with no job_id polling.\n\n- **Disambiguation:** Optional context such as website, city, country, and known aliases sharpens matching when several companies share a similar name.\n- **Control:** Tune results with fuzzy matching, a configurable result count, and a minimum score threshold.\n- **Output:** Ranked, typed company records (legal ids, address, firmographics, parent hierarchy) ready to seed new CRM accounts or enrich existing ones.\n\nIdeal for account creation flows, lead-to-account matching, and keeping your account base clean and de-duplicated."}],"servers":[{"url":"https://api.delpha.io","description":"Production API server"}],"security":[{"oauth2":["api/access"]}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"OAuth2 client credentials flow for API access","flows":{"clientCredentials":{"tokenUrl":"https://secure.delpha.io/oauth2/token","scopes":{"api/access":"Access to the public API"}}}}},"schemas":{"CompanyOutput":{"properties":{"message":{"type":"string","title":"Message","description":"The message to return"},"status":{"type":"string","enum":["SUCCESS","ERROR"],"title":"Status","description":"The status of the process"},"status_code":{"type":"integer","title":"Status Code","description":"The status code to return"},"result":{"anyOf":[{"$ref":"#/components/schemas/CompanyResult"},{"type":"null"}],"description":"The company search result. Present when status == 'SUCCESS'."},"process_time":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Process Time","description":"The processing time of the request, in seconds."}},"type":"object","required":["message","status","status_code"],"title":"CompanyOutput","description":"Public response for the company datalake search."},"CompanyResult":{"properties":{"companies":{"items":{"$ref":"#/components/schemas/Company"},"type":"array","title":"Companies","description":"The list of matching companies for the current page."},"count":{"type":"integer","title":"Count","description":"The number of companies on this page (i.e. ``len(companies)``)."},"total":{"type":"integer","title":"Total","description":"The true number of matching companies. A lower bound when ``total_is_lower_bound`` is true (DDQ-3314)."},"total_is_lower_bound":{"type":"boolean","title":"Total Is Lower Bound","description":"When true, ``total`` is a floor — render as '{total}+' (DDQ-3314).","default":false},"filtered_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Filtered Total","description":"The number of companies **strictly** matching every active filter facet (industry, creation date, employee range, city, country) — records missing that facet's value are excluded, unlike ``total``. Exact up to 1000, else a floor. ``null`` when no facet is active. Use it for the 'N match your filters' headline (DDQ-3337)."},"filtered_total_is_lower_bound":{"type":"boolean","title":"Filtered Total Is Lower Bound","description":"When true, ``filtered_total`` is a floor — render as '{filtered_total}+' (DDQ-3337).","default":false},"page":{"type":"integer","title":"Page","description":"The 1-based page number returned (DDQ-3314).","default":1},"page_size":{"type":"integer","title":"Page Size","description":"The number of companies per page (DDQ-3314).","default":10},"has_more":{"type":"boolean","title":"Has More","description":"Whether a further page of results exists — page with this (DDQ-3314).","default":false}},"type":"object","required":["companies","count","total"],"title":"CompanyResult","description":"The result payload for a successful company search."},"Company":{"properties":{"delpha_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delpha Id","description":"The Delpha internal identifier of the company."},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Name","description":"The name of the company."},"aliases":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Aliases","description":"Alternative names the company is known by."},"input_names":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Input Names","description":"Raw input names matched against this company."},"legal_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Id","description":"The normalized legal identifier."},"legal_id_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Id Type","description":"The type of the legal identifier."},"SIREN":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Siren","description":"The French SIREN identifier."},"SIRET":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Siret","description":"The French SIRET identifier."},"NAF":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Naf","description":"The NAF/APE activity code."},"VAT":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vat","description":"The VAT identifier."},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website","description":"The website of the company."},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"The location label of the company."},"address":{"anyOf":[{"$ref":"#/components/schemas/Address"},{"type":"null"}],"description":"The structured postal address."},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"The status of the company."},"main_company":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Main Company","description":"Whether this record is the main company."},"is_golden":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Golden","description":"Whether this is a golden (master) record."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"A free-text description of the company."},"company_type":{"anyOf":[{"$ref":"#/components/schemas/CompanyType"},{"type":"null"}],"description":"The legal / company-type details."},"industry_division":{"anyOf":[{"$ref":"#/components/schemas/IndustryDivision"},{"type":"null"}],"description":"The industry division / activity."},"annual_revenue":{"anyOf":[{"$ref":"#/components/schemas/MonetaryAmount"},{"type":"null"}],"description":"The annual revenue details."},"employees_nb":{"anyOf":[{"$ref":"#/components/schemas/EmployeeCount"},{"type":"null"}],"description":"The employee-count details."},"group_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Group Size","description":"The number of entities in the company's group."},"creation_date":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Creation Date","description":"The creation date(s) of the company."},"parent":{"anyOf":[{"$ref":"#/components/schemas/CompanyRef"},{"type":"null"}],"description":"The direct parent company."},"ultimate_parent":{"anyOf":[{"$ref":"#/components/schemas/CompanyRef"},{"type":"null"}],"description":"The ultimate parent company."},"matching_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Matching Score","description":"The Atlas Search relevance score (null for exact legal_id matches)."},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","description":"The datalake source of the company."},"last_update":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Update","description":"The ISO-8601 timestamp of the company's last datalake update."}},"additionalProperties":true,"type":"object","title":"Company","description":"A single company result from the datalake search.\n\nDelpha's datalake is heterogeneous across source datasets, so this model\npresents a stable, typed public contract: list-or-scalar fields are\nnormalized to lists, ``last_update`` to an ISO-8601 string, and structured\nfields (``address``, ``company_type``, ``parent`` …) into typed sub-models.\nThe long tail of optional enrichment fields (alternate ids, social handles,\nmarket data …) is forwarded untyped via ``extra=\"allow\"``. Validated against\n120 live records (French, foreign, public and SME)."},"Address":{"properties":{"street":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Street","description":"Street address."},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code","description":"Postal code."},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"City."},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Country name."},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO country code."},"coordinates":{"anyOf":[{"$ref":"#/components/schemas/Coordinates"},{"type":"null"}],"description":"Geographic coordinates."}},"additionalProperties":true,"type":"object","title":"Address","description":"Structured postal address of the company."},"Coordinates":{"properties":{"latitude":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Latitude","description":"Latitude."},"longitude":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Longitude","description":"Longitude."}},"additionalProperties":true,"type":"object","title":"Coordinates","description":"Geographic coordinates of an address."},"CompanyType":{"properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value","description":"Company type value."},"legal_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Type","description":"Legal type label."},"legal_type_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Type Code","description":"Legal type code."}},"additionalProperties":true,"type":"object","title":"CompanyType","description":"Legal / company-type details."},"IndustryDivision":{"properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value","description":"Division / activity code."},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","description":"Classification system."},"desc":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Desc","description":"Human-readable description."}},"additionalProperties":true,"type":"object","title":"IndustryDivision","description":"Industry division / activity classification."},"MonetaryAmount":{"properties":{"value":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Value","description":"Amount (number, or a bucketed range string)."},"profit":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Profit","description":"Associated profit, when available."},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Reference period."},"range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Range","description":"Bucketed range."},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit","description":"Currency / unit."}},"additionalProperties":true,"type":"object","title":"MonetaryAmount","description":"A monetary metric such as annual revenue."},"EmployeeCount":{"properties":{"value":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Value","description":"Headcount."},"min":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Min","description":"Lower bound of the range."},"max":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Max","description":"Upper bound of the range."},"range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Range","description":"Bucketed range."},"time":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Time","description":"Reference year."}},"additionalProperties":true,"type":"object","title":"EmployeeCount","description":"Employee-count details."},"CompanyRef":{"properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value","description":"The referenced company's Delpha id."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"The referenced company name."},"confidence":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Confidence","description":"Link confidence (0-100)."},"wikidata_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wikidata Id","description":"Wikidata id of the referenced company."}},"additionalProperties":true,"type":"object","title":"CompanyRef","description":"Reference to a related company (direct or ultimate parent)."}}},"paths":{"/v1/company":{"get":{"tags":["Company"],"summary":"Search Delpha's datalake for company records","description":"Synchronous company search: query Delpha's company datalake and receive matching records in a single request (no job_id polling). At least one of `account_name`, `legal_id`, or `search_str` must be provided; optional parameters (website, city, country, aliases, fuzzy/scoring) refine and disambiguate the results.","operationId":"searchCompany","responses":{"200":{"description":"Company search succeeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyOutput"}}}},"400":{"description":"Either 'account_name', 'legal_id' or 'search_str' is required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyOutput"}}}},"401":{"description":"Authentication failed - invalid or missing OAuth 2.0 token","content":{"application/json":{"schema":{"properties":{"message":{"type":"string"}},"type":"object"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyOutput"}}}},"502":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyOutput"}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.delpha.io/delpha-api-and-mcp/api/company.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.