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.

Authorizations
Body

Payload to submit a new legal ID quality job.

nameany ofOptional

The name of the entity

Example: Delpha
stringOptional
or
nullOptional
legal_idstringRequired

The legal ID

Example: 88052440000012
legal_id_typestringRequired

The type of legal ID

Example: FRA - SIRET
websiteany ofOptional

The website URL

Example: https://delpha.io/
stringOptional
or
nullOptional
Responses
202

Job submitted to assess_legal_id_v16

application/json
post
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.

Authorizations
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
get
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
}
PreviousNameNextLinkedIn

Was this helpful?