Legal ID

Legal identifiers are the foundation of corporate trust and compliance—yet they often vary in format and structure from one country to another. Delpha's Legal ID Finder and Legal ID Validator simplify the verification and normalization of company registration numbers worldwide, ensuring your records remain consistent, authentic, and enriched with reliable context.

Each request is assessed through several key dimensions:

• Completeness: Detects missing or incomplete identifiers and, when possible, infers the ID type from the provided country.

• Validity: Confirms that the ID follows the official structure and exists within Delpha's trusted registry for supported countries (see documentation for full coverage).

• Consistency: Compares your input with its normalized version, applying the appropriate format, padding, and length rules.

• Accuracy: Verifies whether the provided ID matches contextual data such as company name or address.

When valid, Delpha returns a normalized and enriched record containing structured details like company name, address, website, and industry. If side fields are provided, the Legal ID Finder can also deliver AI-generated recommendations with confidence scores to help identify the correct registered entity.

With Legal ID Finder and Legal ID Validator, you gain a consolidated, cross-country view of legal identifiers—enhancing data quality, reliability, and compliance at scale.

Submit legal ID for finding and validation

post

Submit an legal ID for finding and validation. Returns a job ID for tracking the process.

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:

Body

application/json

Payload to submit a new legal ID quality job.

nameany ofOptional

The name of the entity

Example: Delpha

stringOptional

or

nullOptional

legal_idany ofOptional

The legal ID

Example: 88052440000012

stringOptional

or

nullOptional

legal_id_typeany ofOptional

The type of legal ID

Example: FRA - SIRET

string · enumOptional

Enum representing the possible legal ID types supported by the system.

Possible values:

or

nullOptional

addressany ofOptional

The address of the entity

Example: {"city":"Paris","country":"France","postal_code":"75006","state":"Ile de France","street":"3 AVENUE VAVIN"}

or

nullOptional

websiteany ofOptional

The website URL

Example: https://delpha.io/

stringOptional

or

nullOptional

Responses

202

Job submitted to assess_legal_id_v16

application/json

400

Invalid legal ID format or missing required fields

application/json

401

Authentication failed - invalid or missing OAuth 2.0 token

application/json

402

Payment Required

application/json

500

Internal server error

application/json

502

Service unavailable

application/json

post

/v1/legal-id

HTTPcURLJavaScriptPython

POST /v1/legal-id HTTP/1.1
Host: api.delpha.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 224

{
  "name": "Delpha",
  "legal_id": "88052440000012",
  "legal_id_type": "FRA - SIRET",
  "address": {
    "city": "Paris",
    "country": "France",
    "postal_code": "75006",
    "state": "Ile de France",
    "street": "3 AVENUE VAVIN"
  },
  "website": "https://delpha.io/"
}

{
  "job_id": "21014abc65004d2781d2e0ef4c9fbb46",
  "message": "Job submitted to assess_legal_id_v16",
  "status": "SUCCESS",
  "status_code": 202
}

Get legal ID finder and validator job status

get

Retrieve the result and status of a previously submitted legal ID finder and validator job.

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:

Path parameters

job_idstringRequired

The unique identifier of the legal ID job

Example: {"summary":"Sample job ID","value":"21014abc65004d2781d2e0ef4c9fbb46"}

Responses

200

Job succeeded.

application/json

Response after retrieving the status and result of an legal ID quality job.

messagestringRequired

A human-readable message describing the current state or outcome of the job.

Example: Job succeeded.

statusstring · enumRequired

The status of the process

Example: SUCCESSPossible values:

status_codeintegerRequired

The HTTP status code representing the job's current state.

Example: 200

resultany ofOptional

The result of the legal ID quality job

Example: {"data_type":"legal_id","label":"OK","legal_id_type":"FRA - SIRET","match":{"account_name":"DELPHA","address":{"city":"PARIS 6","country":"FRANCE","country_code":"FR","full_street":"3 AV VAVIN","location":"3 AV VAVIN, PARIS 6, 75006, FRANCE","place_name":"Wojo","postal_code":"75006","state":"","street":"AV VAVIN","street_number":"3"},"annual_revenue":{"range":"10-50","time":"2022","value":"20700000.0"},"company_type":{"legal_id_type_label":null,"legal_type":"SAS, société par actions simplifiée","legal_type_code":"5710","value":"PME"},"date":{"birth_date":null,"closing_date":null,"creation_date":"2020-03-11"},"employees_nb":{"max":9,"min":6,"range":"1-10","value":null},"industry":{"description":"Software Publishers","type":null,"value":"5112"},"legal_id":"88052440000012","legal_id_type":"FRA - SIRET","score":1,"source":"https://annuaire-entreprises.data.gouv.fr/entreprise/88052440000012/","website":{"url":"https://delpha.io/"}},"normalized_value":"88052440000012","scores":{"accuracy":1,"completeness":1,"consistency":1,"validity":1},"suggestions":[{"account_name":"DELPHA","address":{"city":"PARIS 6","country":"FRANCE","country_code":"FR","full_street":"3 AV VAVIN","location":"3 AV VAVIN, PARIS 6, 75006, FRANCE","place_name":"Wojo","postal_code":"75006","state":"","street":"AV VAVIN","street_number":"3"},"annual_revenue":{"range":"10-50","time":"2022","value":"20700000.0"},"company_type":{"legal_id_type_label":null,"legal_type":"SAS, société par actions simplifiée","legal_type_code":"5710","value":"PME"},"date":{"birth_date":null,"closing_date":null,"creation_date":"2020-03-11"},"employees_nb":{"max":9,"min":6,"range":"1-10","value":null},"industry":{"description":"Software Publishers","type":null,"value":"5112"},"legal_id":"88052440000012","legal_id_type":"FRA - SIRET","score":1,"source":"https://annuaire-entreprises.data.gouv.fr/entreprise/88052440000012/","website":{"url":"https://delpha.io/"}}]}

or

nullOptional

process_timeany ofOptional

The total time taken to process the job, in seconds.

Example: 0.123

numberOptional

or

nullOptional

202

Job is still running.

application/json

400

Input validation failed.

application/json

401

Authentication failed - invalid or missing OAuth 2.0 token

application/json

500

Failed to retrieve job.

application/json

504

Job timed out.

application/json

get

/v1/legal-id/{job_id}

HTTPcURLJavaScriptPython

GET /v1/legal-id/{job_id} HTTP/1.1
Host: api.delpha.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "message": "Job succeeded.",
  "status": "SUCCESS",
  "status_code": 200,
  "result": {
    "data_type": "legal_id",
    "normalized_value": "88052440000012",
    "label": "OK",
    "legal_id_type": "FRA - SIRET",
    "scores": {
      "validity": 1,
      "completeness": 1,
      "accuracy": 1,
      "consistency": 1
    },
    "match": {
      "score": 1,
      "account_name": "DELPHA",
      "industry": {
        "value": "5112",
        "description": "Software Publishers",
        "type": null
      },
      "website": {
        "url": "https://delpha.io/"
      },
      "address": {
        "place_name": "Wojo",
        "street_number": "3",
        "street": "AV VAVIN",
        "full_street": "3 AV VAVIN",
        "city": "PARIS 6",
        "state": "",
        "postal_code": "75006",
        "country": "FRANCE",
        "country_code": "FR",
        "location": "3 AV VAVIN, PARIS 6, 75006, FRANCE"
      },
      "annual_revenue": {
        "value": "20700000.0",
        "time": "2022",
        "range": "10-50"
      },
      "employees_nb": {
        "value": null,
        "min": 6,
        "max": 9,
        "range": "1-10"
      },
      "source": "https://annuaire-entreprises.data.gouv.fr/entreprise/88052440000012/",
      "company_type": {
        "value": "PME",
        "legal_type": "SAS, société par actions simplifiée",
        "legal_id_type_label": null,
        "legal_type_code": "5710"
      },
      "date": {
        "creation_date": "2020-03-11",
        "closing_date": null,
        "birth_date": null
      },
      "legal_id_type": "FRA - SIRET",
      "legal_id": "88052440000012"
    },
    "suggestions": [
      {
        "score": 1,
        "account_name": "DELPHA",
        "industry": {
          "value": "5112",
          "description": "Software Publishers",
          "type": null
        },
        "website": {
          "url": "https://delpha.io/"
        },
        "address": {
          "place_name": "Wojo",
          "street_number": "3",
          "street": "AV VAVIN",
          "full_street": "3 AV VAVIN",
          "city": "PARIS 6",
          "state": "",
          "postal_code": "75006",
          "country": "FRANCE",
          "country_code": "FR",
          "location": "3 AV VAVIN, PARIS 6, 75006, FRANCE"
        },
        "annual_revenue": {
          "value": "20700000.0",
          "time": "2022",
          "range": "10-50"
        },
        "employees_nb": {
          "value": null,
          "min": 6,
          "max": 9,
          "range": "1-10"
        },
        "source": "https://annuaire-entreprises.data.gouv.fr/entreprise/88052440000012/",
        "company_type": {
          "value": "PME",
          "legal_type": "SAS, société par actions simplifiée",
          "legal_id_type_label": null,
          "legal_type_code": "5710"
        },
        "date": {
          "creation_date": "2020-03-11",
          "closing_date": null,
          "birth_date": null
        },
        "legal_id_type": "FRA - SIRET",
        "legal_id": "88052440000012"
      }
    ]
  },
  "process_time": 0.123
}