> 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":"2.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"]},{"apiKey":[]}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"OAuth 2.0 client-credentials flow (machine-to-machine). Token URL: https://secure.delpha.io/oauth2/token. The `api/access` scope is all-access: it grants every operation this document publishes. Per-use-case scoping, per-key credit ceilings and expiry are properties of an API key, not of this flow — use an API key when a credential must be restricted.","flows":{"clientCredentials":{"tokenUrl":"https://secure.delpha.io/oauth2/token","scopes":{"api/access":"Access to the public API"}}}},"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"dlp_","description":"Native Delpha API key. Send it as an HTTP bearer token (`Authorization: Bearer dlp_...`). Keys are issued from the Delpha app (Developer → API keys) and are billed per team against the team's credit balance."}},"schemas":{"CompanyOutput":{"additionalProperties":true,"description":"Public response for the company datalake search.","properties":{"code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Stable machine-readable status/error code (see ErrorCode).","title":"Code"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The API Gateway request id, for support correlation.","title":"Request Id"},"doc_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Link to error documentation (present when published).","title":"Doc Url"},"message":{"description":"The message to return","title":"Message","type":"string"},"status":{"description":"The status of the process","enum":["SUCCESS","ERROR"],"title":"Status","type":"string"},"status_code":{"description":"The status code to return","title":"Status Code","type":"integer"},"result":{"anyOf":[{"$ref":"#/components/schemas/CompanyResult"},{"type":"null"}],"default":null,"description":"The company search result. Present when status == 'SUCCESS'."},"process_time":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"The processing time of the request, in seconds.","title":"Process Time"}},"required":["message","status","status_code"],"title":"CompanyOutput","type":"object"},"CompanyResult":{"additionalProperties":true,"description":"The result payload for a successful company search.","properties":{"companies":{"description":"The list of matching companies for the current page.","items":{"$ref":"#/components/schemas/Company"},"title":"Companies","type":"array"},"count":{"description":"The number of companies on this page (i.e. ``len(companies)``).","title":"Count","type":"integer"},"total":{"description":"The true number of matching companies. A lower bound when ``total_is_lower_bound`` is true.","title":"Total","type":"integer"},"total_is_lower_bound":{"default":false,"description":"When true, ``total`` is a floor — render as '{total}+'.","title":"Total Is Lower Bound","type":"boolean"},"filtered_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"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.","title":"Filtered Total"},"filtered_total_is_lower_bound":{"default":false,"description":"When true, ``filtered_total`` is a floor — render as '{filtered_total}+'.","title":"Filtered Total Is Lower Bound","type":"boolean"},"page":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":1,"description":"The 1-based page number returned, or `null` when the page was addressed by `cursor` — a cursor is a position in the result set, not a page number.","title":"Page"},"page_size":{"default":10,"description":"The number of companies per page.","title":"Page Size","type":"integer"},"has_more":{"default":false,"description":"Whether a further page of results exists — page with this.","title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Opaque cursor for the next page: send it back as `cursor` with the same search parameters. `null` when there is no further page. Authoritative — walk until it is `null` rather than counting against `total`.","title":"Next Cursor"}},"required":["companies","count","total"],"title":"CompanyResult","type":"object"},"Company":{"additionalProperties":true,"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).","properties":{"delpha_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The Delpha internal identifier of the company.","title":"Delpha Id"},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The name of the company.","title":"Account Name"},"aliases":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Alternative names the company is known by.","title":"Aliases"},"input_names":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Raw input names matched against this company.","title":"Input Names"},"legal_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The normalized legal identifier.","title":"Legal Id"},"legal_id_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The type of the legal identifier.","title":"Legal Id Type"},"SIREN":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The French SIREN identifier.","title":"Siren"},"SIRET":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The French SIRET identifier.","title":"Siret"},"NAF":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The NAF/APE activity code.","title":"Naf"},"VAT":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The VAT identifier.","title":"Vat"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The website of the company.","title":"Website"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The location label of the company.","title":"Location"},"address":{"anyOf":[{"$ref":"#/components/schemas/Address"},{"type":"null"}],"default":null,"description":"The structured postal address."},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The status of the company.","title":"Status"},"site_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Whether this record is the company's headquarters: 'headquarters', 'branch', or 'unknown' when the datalake holds no value. Replaces the former boolean 'main_company'. Open vocabulary -- new values may be added, so treat this as a string, not a closed enum.","title":"Site Type"},"is_golden":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Whether this is a golden (master) record.","title":"Is Golden"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A free-text description of the company.","title":"Description"},"company_type":{"anyOf":[{"$ref":"#/components/schemas/CompanyType"},{"type":"null"}],"default":null,"description":"The legal / company-type details."},"industry_division":{"anyOf":[{"$ref":"#/components/schemas/IndustryDivision"},{"type":"null"}],"default":null,"description":"The industry division / activity."},"financials":{"anyOf":[{"$ref":"#/components/schemas/Financials"},{"type":"null"}],"default":null,"description":"Filed financial figures for the company's most recent fiscal period, as published by its national register. Replaces the former `annual_revenue` field, which is no longer returned."},"employees_nb":{"anyOf":[{"$ref":"#/components/schemas/EmployeeCount"},{"type":"null"}],"default":null,"description":"The employee-count details."},"group_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"The number of entities in the company's group.","title":"Group Size"},"creation_date":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"The creation date(s) of the company.","title":"Creation Date"},"parent":{"anyOf":[{"$ref":"#/components/schemas/CompanyRef"},{"type":"null"}],"default":null,"description":"The direct parent company."},"ultimate_parent":{"anyOf":[{"$ref":"#/components/schemas/CompanyRef"},{"type":"null"}],"default":null,"description":"The ultimate parent company."},"headquarters_site":{"anyOf":[{"$ref":"#/components/schemas/HeadquartersSite"},{"type":"null"}],"default":null,"description":"The company's headquarters site, with its legal identifier. Derived from the same datalake link as 'parent', which is retained and carries the parent's Delpha id instead."},"matching_score":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"The Atlas Search relevance score (null for exact legal_id matches).","title":"Matching Score"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The datalake source of the company.","title":"Source"},"last_update":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The ISO-8601 timestamp of the company's last datalake update.","title":"Last Update"}},"title":"Company","type":"object"},"Address":{"additionalProperties":true,"description":"Structured postal address of the company.","properties":{"street":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Street address.","title":"Street"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Postal code.","title":"Postal Code"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City.","title":"City"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Country name.","title":"Country"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO country code.","title":"Country Code"},"coordinates":{"anyOf":[{"$ref":"#/components/schemas/Coordinates"},{"type":"null"}],"default":null,"description":"Geographic coordinates."}},"title":"Address","type":"object"},"Coordinates":{"additionalProperties":true,"description":"Geographic coordinates of an address.","properties":{"latitude":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"default":null,"description":"Latitude.","title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"default":null,"description":"Longitude.","title":"Longitude"}},"title":"Coordinates","type":"object"},"CompanyType":{"additionalProperties":true,"description":"Legal / company-type details.","properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Company type value.","title":"Value"},"legal_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Legal type label.","title":"Legal Type"},"legal_type_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Legal type code.","title":"Legal Type Code"}},"title":"CompanyType","type":"object"},"IndustryDivision":{"additionalProperties":true,"description":"Industry division / activity classification.","properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Division / activity code.","title":"Value"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Classification system.","title":"Type"},"desc":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Human-readable description.","title":"Desc"}},"title":"IndustryDivision","type":"object"},"Financials":{"additionalProperties":true,"description":"Filed financial figures for one fiscal period.\n\nAmounts are exactly as filed, in `currency` -- nothing is converted. Which\nfigures are present depends on what the national register publishes: some\nfile a full profit-and-loss, others only a balance sheet.","properties":{"revenue":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"default":null,"description":"Revenue / total operating income for the period, in `currency`.","title":"Revenue"},"operating_profit":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"default":null,"description":"Operating profit (EBIT-level result) for the period, in `currency`. Only some national registers publish it.","title":"Operating Profit"},"net_income":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"default":null,"description":"Net result for the period, after tax, in `currency`.","title":"Net Income"},"equity":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"default":null,"description":"Total equity at the end of the period, in `currency`. Only some national registers publish it.","title":"Equity"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO 4217 currency every amount here is filed in.","title":"Currency"},"fiscal_period":{"anyOf":[{"$ref":"#/components/schemas/FiscalPeriod"},{"type":"null"}],"default":null,"description":"The period the figures cover."},"revenue_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Bucketed revenue, in millions of `currency`. No currency conversion is applied, so read it together with `currency`.","title":"Revenue Range"}},"title":"Financials","type":"object"},"FiscalPeriod":{"additionalProperties":true,"description":"The period a set of filed figures covers.","properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First day of the fiscal period (ISO 8601 date). Not every national register publishes it.","title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Last day of the fiscal period (ISO 8601 date).","title":"End Date"}},"title":"FiscalPeriod","type":"object"},"EmployeeCount":{"additionalProperties":true,"description":"Employee-count details.","properties":{"value":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"default":null,"description":"Headcount.","title":"Value"},"min":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"default":null,"description":"Lower bound of the range.","title":"Min"},"max":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"default":null,"description":"Upper bound of the range.","title":"Max"},"range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Bucketed range.","title":"Range"},"time":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Reference year.","title":"Time"}},"title":"EmployeeCount","type":"object"},"CompanyRef":{"additionalProperties":true,"description":"Reference to a related company (direct or ultimate parent).","properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The referenced company's Delpha id.","title":"Value"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The referenced company name.","title":"Name"},"confidence":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Link confidence (0-100).","title":"Confidence"},"wikidata_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Wikidata id of the referenced company.","title":"Wikidata Id"}},"title":"CompanyRef","type":"object"},"HeadquartersSite":{"additionalProperties":true,"description":"The company's headquarters site, resolved from the datalake parent link.","properties":{"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The headquarters site's company name.","title":"Company Name"},"legal_id":{"anyOf":[{"$ref":"#/components/schemas/HeadquartersLegalId"},{"type":"null"}],"default":null,"description":"The headquarters site's legal identifier. Absent when the parent record could not be resolved in the datalake."}},"title":"HeadquartersSite","type":"object"},"HeadquartersLegalId":{"description":"The headquarters site's legal identifier.","properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The legal identifier value.","title":"Value"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The type of the legal identifier.","title":"Type"}},"title":"HeadquartersLegalId","type":"object"},"Error":{"type":"object","title":"Error","description":"Typed error envelope emitted by the API for handler-level 4xx/5xx responses. Extends the success envelope with a stable machine-readable `code` and a correlation `request_id`.","properties":{"status":{"type":"string","enum":["ERROR"],"description":"Always \"ERROR\" for an error response."},"status_code":{"type":"integer","description":"The HTTP status code of the response."},"message":{"type":"string","description":"Human-readable, PII-free error message."},"code":{"type":"string","enum":["validation_error","unauthorized","payment_required","not_found","conflict","rate_limited","backend_error","backend_timeout","service_unavailable","job_timeout","internal_error","unsupported_registry","idempotency_key_reuse","idempotency_in_progress","idempotency_key_invalid"],"description":"Stable machine-readable error code. `ok` and `job_running` are the success-side codes and never appear in an error body."},"request_id":{"type":"string","description":"API Gateway request id, for support correlation. The same value is returned in the `x-amzn-RequestId` response header on every response, including the 401/403/429 API Gateway generates itself."},"doc_url":{"type":"string","description":"Link to error documentation. Present when error documentation is published."}},"required":["status","status_code","message"],"additionalProperties":true},"GatewayError":{"type":"object","title":"GatewayError","description":"Error body returned by API Gateway itself, before a handler runs: 401 (no or invalid credential), 403 (the API key's scopes do not cover this operation, or the path is not routed here) and 429 (stage throttle; carries `Retry-After`). It has no `code` and no `request_id`; correlate it through the `x-amzn-RequestId` response header instead. A 401 a handler emits after the gateway admitted the request carries the full `Error` envelope.","properties":{"status":{"type":"string","enum":["ERROR"],"description":"Always \"ERROR\"."},"status_code":{"type":"integer","description":"The HTTP status code of the response (401, 403 or 429)."},"message":{"type":"string","description":"Human-readable error message."}},"required":["message"],"additionalProperties":true}},"headers":{"RateLimitLimit":{"description":"Your request allowance for this operation in the current 60-second window. It is counted per credential owner AND per operation: spending it on one operation does not reduce what you may send to another.","schema":{"type":"string"}},"RateLimitRemaining":{"description":"Requests still available to you on this operation in the current window. `0` on the request that exhausts it and on the refusals that follow.","schema":{"type":"string"}},"RateLimitReset":{"description":"When the current window resets, as **UTC epoch seconds** — an absolute instant, not a number of seconds to wait. Use `Retry-After` for the delay.","schema":{"type":"string"}},"RateLimit":{"description":"What is left of the allowance, as a structured field of `draft-ietf-httpapi-ratelimit-headers` (an Internet-Draft, not a published standard): `\"<policy>\";r=<remaining>;t=<seconds to reset>`. Exactly one policy governs a request, so the list always carries one member.","schema":{"type":"string"}},"RateLimitPolicy":{"description":"The allowance that governed this request, as a structured field of `draft-ietf-httpapi-ratelimit-headers` (an Internet-Draft, not a published standard): `\"<policy>\";q=<quota>;w=<window seconds>`. `submit` governs submit and synchronous operations, `poll` the poll operations; the policy for each operation is also published in its `x-rate-limit`.","schema":{"type":"string"}},"DelphaMode":{"description":"Present on every response the API renders to a **test-mode** key, and on no other: absence means the call was live. A test-mode call is answered from the published fixture table, reserves no credits and reaches no verification backend. The 401, 403 and shared-floor 429 the gateway answers before the API sees the request carry no per-request headers, so they never carry this one. See the *Test mode* section of this document.","schema":{"type":"string","enum":["sandbox"]}}}},"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":"Job succeeded — the result payload is populated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyOutput"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"X-Delpha-Mode":{"$ref":"#/components/headers/DelphaMode"},"X-Delpha-Job-Id":{"description":"The reservation's job id for this call (present once admission succeeded, including on post-admission errors). Use it to address the same call in the Delpha AI console's history (Logs / Resolutions).","schema":{"type":"string"}}}},"400":{"description":"Validation error — the request body or query parameters were rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"X-Delpha-Mode":{"$ref":"#/components/headers/DelphaMode"}}},"401":{"description":"Authentication failed — invalid or missing OAuth 2.0 token or API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayError"}}},"headers":{}},"402":{"description":"Payment required — the team has insufficient credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"X-Delpha-Mode":{"$ref":"#/components/headers/DelphaMode"}}},"403":{"description":"Forbidden — the credential is valid but not allowed here: the API key's scopes do not cover this operation, or the operation is not routed in this environment (API Gateway then answers `Missing Authentication Token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayError"}}},"headers":{}},"409":{"description":"Conflict — the credit reservation expired before delivery; resubmit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"X-Delpha-Mode":{"$ref":"#/components/headers/DelphaMode"},"X-Delpha-Job-Id":{"description":"The reservation's job id for this call (present once admission succeeded, including on post-admission errors). Use it to address the same call in the Delpha AI console's history (Logs / Resolutions).","schema":{"type":"string"}}}},"422":{"description":"Unprocessable entity — the query is well-formed but the `cursor` cannot be honoured (`validation_error`): `page` and `cursor` were sent together, the cursor is not a cursor this API issued, it belongs to a different query, or the search itself would not accept it. Restart from the first page — the first three are refused before any credit is reserved, and the fourth releases its reservation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"X-Delpha-Mode":{"$ref":"#/components/headers/DelphaMode"}}},"429":{"description":"Too many requests — one of two limits was exceeded. Your allowance for this operation in the current 60-second window: an `Error` body with `code: rate_limited`, `Retry-After` set to the seconds left in the window, and the quota headers with `X-RateLimit-Remaining: 0`; nothing is charged. Or the per-operation floor every caller of that operation shares: a `GatewayError` body with `Retry-After: 1` and no quota headers, refused before the API sees the request.","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/Error"},{"$ref":"#/components/schemas/GatewayError"}]}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying: the time left in your current window on the allowance refusal, and `1` on the shared per-operation floor.","schema":{"type":"integer"}},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit","description":"Present on the allowance refusal only. The shared per-operation floor is refused by the gateway, whose responses carry no quota headers."},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining","description":"Present on the allowance refusal only. The shared per-operation floor is refused by the gateway, whose responses carry no quota headers."},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset","description":"Present on the allowance refusal only. The shared per-operation floor is refused by the gateway, whose responses carry no quota headers."},"RateLimit":{"$ref":"#/components/headers/RateLimit","description":"Present on the allowance refusal only. The shared per-operation floor is refused by the gateway, whose responses carry no quota headers."},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy","description":"Present on the allowance refusal only. The shared per-operation floor is refused by the gateway, whose responses carry no quota headers."},"X-Delpha-Mode":{"$ref":"#/components/headers/DelphaMode","description":"Present on the allowance refusal only. The shared per-operation floor is refused by the gateway, whose responses carry no per-request headers."}}},"502":{"description":"Bad gateway — the upstream service returned an error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"X-Delpha-Mode":{"$ref":"#/components/headers/DelphaMode"},"X-Delpha-Job-Id":{"description":"The reservation's job id for this call (present once admission succeeded, including on post-admission errors). Use it to address the same call in the Delpha AI console's history (Logs / Resolutions).","schema":{"type":"string"}}}},"503":{"description":"Service unavailable — a downstream dependency was unreachable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"X-Delpha-Mode":{"$ref":"#/components/headers/DelphaMode"},"X-Delpha-Job-Id":{"description":"The reservation's job id for this call (present once admission succeeded, including on post-admission errors). Use it to address the same call in the Delpha AI console's history (Logs / Resolutions).","schema":{"type":"string"}}}},"504":{"description":"Gateway timeout — the job exceeded its processing ceiling.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"X-Delpha-Mode":{"$ref":"#/components/headers/DelphaMode"},"X-Delpha-Job-Id":{"description":"The reservation's job id for this call (present once admission succeeded, including on post-admission errors). Use it to address the same call in the Delpha AI console's history (Logs / Resolutions).","schema":{"type":"string"}}}}},"parameters":[{"name":"account_name","in":"query","required":false,"description":"The company name to search for.","schema":{"type":"string"}},{"name":"legal_id","in":"query","required":false,"description":"A legal identifier to look up (exact match).","schema":{"type":"string"}},{"name":"legal_id_type","in":"query","required":false,"description":"The type of the provided legal identifier.","schema":{"type":"string"}},{"name":"search_str","in":"query","required":false,"description":"Unified single-field search: a company name OR a legal id.","schema":{"type":"string"}},{"name":"website","in":"query","required":false,"description":"The company website (sharpens disambiguation).","schema":{"type":"string","format":"uri"}},{"name":"city","in":"query","required":false,"description":"A city. Strict filter: only companies in this city are returned; companies with no city on record are still returned, last.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"A country name. Strict filter: only companies in this country are returned; companies with no country on record are still returned, last.","schema":{"type":"string"}},{"name":"country_code","in":"query","required":false,"description":"An ISO 3166-1 alpha-2 country code. Strict filter: only companies in this country are returned; companies with no country on record are still returned, last.","schema":{"type":"string","pattern":"^[A-Z]{2}$"}},{"name":"aliases","in":"query","required":false,"description":"Post-filter on aliases; repeatable (?aliases=a&aliases=b).","schema":{"type":"array","items":{"type":"string"}}},{"name":"input_names","in":"query","required":false,"description":"Post-filter on input names; repeatable.","schema":{"type":"array","items":{"type":"string"}}},{"name":"page","in":"query","required":false,"description":"1-based page number to return.","schema":{"type":"integer","minimum":1,"default":1}},{"name":"page_size","in":"query","required":false,"description":"Number of companies per page, max 100.","schema":{"type":"integer","minimum":1,"maximum":100,"default":10}},{"name":"top_k","in":"query","required":false,"description":"Deprecated — use page_size. Used as the page size when page_size is omitted.","schema":{"type":"integer","minimum":1,"maximum":100},"deprecated":true},{"name":"fuzzy","in":"query","required":false,"description":"Whether to enable fuzzy (typo-tolerant) matching.","schema":{"type":"boolean","default":true}},{"name":"score_threshold","in":"query","required":false,"description":"Minimum match score for a result to be returned.","schema":{"type":"number"}},{"name":"creation_date_from","in":"query","required":false,"description":"Founding-date lower bound (ISO date or a year). Strict filter: companies founded before it are excluded; companies with no founding date on record are still returned, last.","schema":{"type":"string"}},{"name":"creation_date_to","in":"query","required":false,"description":"Founding-date upper bound (ISO date or a year). Strict filter: companies founded after it are excluded; companies with no founding date on record are still returned, last.","schema":{"type":"string"}},{"name":"industry_division","in":"query","required":false,"description":"Industry classification code(s), e.g. ISIC 8510 or NACE 84.11; repeatable. Dot and dot-less spellings are matched across code systems. Strict filter: only companies matching any supplied code are returned; companies with no industry code on record are still returned, last.","schema":{"type":"array","items":{"type":"string"}}},{"name":"employee_range","in":"query","required":false,"description":"Headcount band(s) from the fixed set. Repeatable. Strict filter: only companies whose headcount band equals any supplied band are returned; companies with no headcount band on record are still returned, last. Labels outside the set are ignored.","schema":{"type":"array","items":{"type":"string","enum":["0","1-10","11-50","51-200","201-500","501-1000","1001-5000","5001-10000",">10000"]}}},{"name":"cursor","in":"query","required":false,"description":"Opaque pagination cursor, taken verbatim from a previous response's next_cursor. Repeat the same search parameters with it to get the next page, and keep going until next_cursor is null. Mutually exclusive with page (sending both is 422); page_size may change mid-walk. A cursor belongs to the query that issued it.","schema":{"type":"string","pattern":"^[A-Za-z0-9_-]+$"}}]}}}}
```


---

# 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.