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

get

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.

Required scopes

This endpoint requires the following scopes:

• : Access to the public API

Authorizations

oauth2

OAuth2clientCredentialsRequired

OAuth2 client credentials flow for API access

Token URL:

Query parameters

account_namestringOptional

The company name to search for.

Example: {"value":"Tesla"}

legal_idstringOptional

A legal identifier to look up (exact match).

Example: {"value":"632012100"}

legal_id_typestringOptional

The type of the provided legal identifier.

Example: {"value":"FRA - SIRET"}

search_strstringOptional

Unified single-field search: a company name OR a legal id.

Example: {"value":"Tesla"}

websitestringOptional

The company website (sharpens disambiguation).

Example: {"value":"https://www.tesla.com"}

citystringOptional

A city. Strict filter: only companies in this city are returned; companies with no city on record are still returned, last.

Example: {"value":"Paris"}

countrystringOptional

A country name. Strict filter: only companies in this country are returned; companies with no country on record are still returned, last.

Example: {"value":"France"}

country_codestringOptional

An ISO country code. Strict filter: only companies in this country are returned; companies with no country on record are still returned, last.

Example: {"value":"FR"}

aliasesstring[]Optional

Post-filter on aliases; repeatable (?aliases=a&aliases=b).

Example: {"value":"Tesla Motors"}

input_namesstring[]Optional

Post-filter on input names; repeatable.

Example: {"value":"tesla"}

pageintegerOptional

1-based page number to return (default 1).

Example: {"value":1}

page_sizeintegerOptional

Number of companies per page, max 100 (default 10).

Example: {"value":10}

top_kintegerOptional

Deprecated — use page_size. Used as the page size when page_size is omitted.

Example: {"value":20}

fuzzybooleanOptional

Whether to enable fuzzy (typo-tolerant) matching (default true).

Example: {"value":true}

score_thresholdnumberOptional

Minimum match score for a result to be returned.

Example: {"value":0.8}

creation_date_fromstringOptional

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.

Example: {"value":"1990"}

creation_date_tostringOptional

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.

Example: {"value":"2010"}

industry_divisionstring[]Optional

Industry classification code(s), e.g. ISIC 8510 or NACE 84.11; repeatable. Dot and dot-less spellings are matched across code systems (8411 also matches 84.11/84.110). Strict filter: only companies matching any supplied code are returned; companies with no industry code on record are still returned, last.

Example: {"value":"8510"}

employee_rangestring[]Optional

Headcount band(s) from the fixed set 0, 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, >10000; 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.

Example: {"value":"51-200"}

Responses

200

Company search succeeded

application/json

Public response for the company datalake search.

messagestringRequired

The message to return

Example: Company search succeeded

statusstring · enumRequired

The status of the process

Example: SUCCESSPossible values:

status_codeintegerRequired

The status code to return

Example: 200

process_timenumber · nullableOptional

The processing time of the request, in seconds.

Example: 0.42

400

Either 'account_name', 'legal_id' or 'search_str' is required

application/json

401

Authentication failed - invalid or missing OAuth 2.0 token

application/json

402

Payment Required

application/json

502

Service unavailable

application/json

get/v1/company

HTTPcURLJavaScriptPython

GET /v1/company HTTP/1.1
Host: api.delpha.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "message": "Company search succeeded",
  "status": "SUCCESS",
  "status_code": 200,
  "result": {
    "companies": [
      {
        "delpha_id": "a9faabec809841a9a4a5b19904754193",
        "account_name": "L'OREAL",
        "aliases": [
          "L'OREAL"
        ],
        "input_names": [
          "loreal"
        ],
        "legal_id": "63201210000012",
        "legal_id_type": "FRA - SIRET",
        "SIREN": "632012100",
        "SIRET": "63201210000012",
        "NAF": "2042Z",
        "VAT": "FR40632012100",
        "website": "https://www.loreal.com",
        "location": "Clichy, France",
        "address": {
          "street": "14 RUE ROYALE",
          "postal_code": "75008",
          "city": "PARIS",
          "country": "France",
          "country_code": "FR",
          "coordinates": {
            "latitude": 48.868137,
            "longitude": 2.323306
          }
        },
        "status": "active",
        "main_company": true,
        "is_golden": false,
        "description": "Cosmetics manufacturer.",
        "company_type": {
          "value": "SAI",
          "legal_type": "SA à conseil d'administration",
          "legal_type_code": "5599"
        },
        "industry_division": {
          "value": "4649",
          "type": "SBI",
          "desc": "Software Development"
        },
        "annual_revenue": {
          "value": 32287600600,
          "profit": 4602200100,
          "time": "2021",
          "range": ">10000",
          "unit": "EUR"
        },
        "employees_nb": {
          "value": 9999,
          "min": 5000,
          "max": 9999,
          "range": "5001-10000",
          "time": 2021
        },
        "group_size": 1,
        "creation_date": [
          "1963-01-01"
        ],
        "parent": {
          "value": "8fdd1f132e0844cca31451de152cec34",
          "name": "L'OREAL",
          "confidence": 100,
          "wikidata_id": "Q160289"
        },
        "ultimate_parent": {
          "value": "8fdd1f132e0844cca31451de152cec34",
          "name": "L'OREAL",
          "confidence": 100,
          "wikidata_id": "Q160289"
        },
        "matching_score": 94.78202056884766,
        "source": "https://annuaire-entreprises.data.gouv.fr/entreprise/63201210000012",
        "last_update": "2026-01-29T16:20:03.935879+00:00"
      }
    ],
    "count": 10,
    "total": 137,
    "total_is_lower_bound": false,
    "filtered_total": 12,
    "filtered_total_is_lower_bound": false,
    "page": 1,
    "page_size": 10,
    "has_more": true
  },
  "process_time": 0.42
}