# 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

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

```json
{"openapi":"3.1.0","info":{"title":"Delpha Data Quality API","version":"1.0.0"},"tags":[{"name":"Legal ID","description":"Legal identifiers are the foundation of corporate trust and compliance—yet they often vary in format and structure from one country to another.\nDelpha'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.\n\nEach request is assessed through several key dimensions:\n- **Completeness:** Detects missing or incomplete identifiers and, when possible, infers the ID type from the provided country.\n- **Validity:** Confirms that the ID follows the official structure and exists within Delpha's trusted registry for supported countries (see documentation for full coverage).\n- **Consistency:** Compares your input with its normalized version, applying the appropriate format, padding, and length rules.\n- **Accuracy:** Verifies whether the provided ID matches contextual data such as company name or address.\n\nWhen 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.\n\nWith **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."}],"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":{"LegalIDSubmitInput":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"The name of the entity"},"legal_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Id","description":"The legal ID"},"legal_id_type":{"anyOf":[{"$ref":"#/components/schemas/LegalIDType"},{"type":"null"}],"description":"The type of legal ID"},"address":{"anyOf":[{"$ref":"#/components/schemas/AddressInput"},{"type":"null"}],"description":"The address of the entity"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website","description":"The website URL"}},"type":"object","title":"LegalIDSubmitInput","description":"Payload to submit a new legal ID quality job."},"LegalIDType":{"type":"string","enum":["FRA - SIRET","FRA - SIREN","NZL - NZBN","AUS - ABN","NOR - ORGANISASJONSNUMMER","CHE - UID","GBR - COMPANY REGISTRATION NUMBER","BEL - ENTERPRISE NUMBER","BGR - UIC","CZE - ICO","DNK - CVR","DEU - HANDELSREGISTERNUMMER","EST - COMMERCIAL REGISTER CODE","IRL - CRO NUMBER","GRC - GEMI","ESP - NIF","HRV - OIB","ITA - CODICE FISCALE","CYP - REGISTRATION NUMBER","LVA - REGISTRATION NUMBER","LTU - IMONES KODAS","LUX - MATRICULE","HUN - CEGJEGYZEKSZAM","MLT - COMPANY REGISTRATION NUMBER","NLD - KVK-NUMMER","AUT - FIRMENBUCHNUMMER","POL - KRS","PRT - NIPC","ROU - NUMAR DE INREGISTRARE","SVN - MATICNA STEVILKA","SVK - ICO","FIN - Y-TUNNUS","SWE - ORGANISATIONSNUMMER","LIE - HANDELSREGISTER-NUMMER","USA - CIK","USA - EIN"],"title":"LegalIDType","description":"Enum representing the possible legal ID types supported by the system."},"AddressInput":{"properties":{"street":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Street","description":"The street"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"The city"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State","description":"The state"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code","description":"The zip code"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"The country"}},"type":"object","title":"AddressInput","description":"Model representing an address."},"LegalIDSubmitOutput":{"properties":{"job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id","description":"The job ID. Required if status <= 300."},"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"}},"type":"object","required":["message","status","status_code"],"title":"LegalIDSubmitOutput","description":"Response after submitting a new legal ID quality job."}}},"paths":{"/v1/legal-id":{"post":{"tags":["Legal ID"],"summary":"Submit legal ID for finding and validation","description":"Submit an legal ID for finding and validation. Returns a job ID for tracking the process.","operationId":"findAndValidateLegalID","requestBody":{"description":"\n\n**Validation Rules:**\n\n- **Required for both modes:** Either `legal_id_type` or `address.country` must be provided (to determine the type of legal ID)\n- **Validation mode:** `legal_id` must be provided\n- **Recommendation mode:** `name` must be provided\n- If all fields are provided, both validation and recommendation will be performed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegalIDSubmitInput"}}},"required":true},"responses":{"202":{"description":"Job submitted to assess_legal_id_v16","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegalIDSubmitOutput"}}}},"400":{"description":"Invalid legal ID format or missing required fields","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegalIDSubmitOutput"}}}},"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/LegalIDSubmitOutput"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegalIDSubmitOutput"}}}},"502":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegalIDSubmitOutput"}}}}}}}}}
```

## Get legal ID finder and validator job status

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

```json
{"openapi":"3.1.0","info":{"title":"Delpha Data Quality API","version":"1.0.0"},"tags":[{"name":"Legal ID","description":"Legal identifiers are the foundation of corporate trust and compliance—yet they often vary in format and structure from one country to another.\nDelpha'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.\n\nEach request is assessed through several key dimensions:\n- **Completeness:** Detects missing or incomplete identifiers and, when possible, infers the ID type from the provided country.\n- **Validity:** Confirms that the ID follows the official structure and exists within Delpha's trusted registry for supported countries (see documentation for full coverage).\n- **Consistency:** Compares your input with its normalized version, applying the appropriate format, padding, and length rules.\n- **Accuracy:** Verifies whether the provided ID matches contextual data such as company name or address.\n\nWhen 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.\n\nWith **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."}],"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":{"LegalIDPullOutput":{"properties":{"message":{"type":"string","title":"Message","description":"A human-readable message describing the current state or outcome of the job."},"status":{"type":"string","enum":["SUCCESS","ERROR"],"title":"Status","description":"The status of the process"},"status_code":{"type":"integer","title":"Status Code","description":"The HTTP status code representing the job's current state."},"result":{"anyOf":[{"$ref":"#/components/schemas/LegalIDModel"},{"type":"null"}],"description":"The result of the legal ID quality job"},"process_time":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Process Time","description":"The total time taken to process the job, in seconds."}},"type":"object","required":["message","status","status_code"],"title":"LegalIDPullOutput","description":"Response after retrieving the status and result of an legal ID quality job."},"LegalIDModel":{"properties":{"data_type":{"$ref":"#/components/schemas/DataType","description":"The type of data for this field"},"normalized_value":{"type":"string","title":"Normalized Value","description":"Normalized legal ID value."},"label":{"type":"string","enum":["No","OK","Unknown"],"title":"Label","description":"Label for the legal ID."},"legal_id_type":{"anyOf":[{"$ref":"#/components/schemas/LegalIDType"},{"type":"null"}],"description":"The type of legal ID"},"scores":{"$ref":"#/components/schemas/ScoresModel","description":"Scores for the field"},"match":{"anyOf":[{"$ref":"#/components/schemas/LegalIDSuggestion"},{"type":"null"}],"description":"The match information"},"suggestions":{"items":{"$ref":"#/components/schemas/LegalIDSuggestion"},"type":"array","title":"Suggestions","description":"Suggestions for the legal ID."}},"type":"object","required":["data_type","normalized_value","label","legal_id_type","scores","suggestions"],"title":"LegalIDModel","description":"Model representing the details of a legal ID field."},"DataType":{"type":"string","enum":["email","social_network","name","legal_id","phone","address","website"],"title":"DataType"},"LegalIDType":{"type":"string","enum":["FRA - SIRET","FRA - SIREN","NZL - NZBN","AUS - ABN","NOR - ORGANISASJONSNUMMER","CHE - UID","GBR - COMPANY REGISTRATION NUMBER","BEL - ENTERPRISE NUMBER","BGR - UIC","CZE - ICO","DNK - CVR","DEU - HANDELSREGISTERNUMMER","EST - COMMERCIAL REGISTER CODE","IRL - CRO NUMBER","GRC - GEMI","ESP - NIF","HRV - OIB","ITA - CODICE FISCALE","CYP - REGISTRATION NUMBER","LVA - REGISTRATION NUMBER","LTU - IMONES KODAS","LUX - MATRICULE","HUN - CEGJEGYZEKSZAM","MLT - COMPANY REGISTRATION NUMBER","NLD - KVK-NUMMER","AUT - FIRMENBUCHNUMMER","POL - KRS","PRT - NIPC","ROU - NUMAR DE INREGISTRARE","SVN - MATICNA STEVILKA","SVK - ICO","FIN - Y-TUNNUS","SWE - ORGANISATIONSNUMMER","LIE - HANDELSREGISTER-NUMMER","USA - CIK","USA - EIN"],"title":"LegalIDType","description":"Enum representing the possible legal ID types supported by the system."},"ScoresModel":{"properties":{"accuracy":{"type":"number","maximum":1,"minimum":-1,"title":"Accuracy","description":"Accuracy score","default":-1},"validity":{"type":"integer","maximum":1,"minimum":-1,"title":"Validity","description":"Validity score","default":-1},"completeness":{"type":"number","maximum":1,"minimum":0,"title":"Completeness","description":"Completeness score","default":0},"consistency":{"type":"integer","maximum":1,"minimum":0,"title":"Consistency","description":"Consistency score","default":0}},"type":"object","title":"ScoresModel","description":"Model representing the scores for an email field."},"LegalIDSuggestion":{"properties":{"score":{"type":"number","maximum":1,"minimum":0,"title":"Score","description":"Confidence score for the suggestion."},"account_name":{"type":"string","title":"Account Name","description":"The account name"},"industry":{"$ref":"#/components/schemas/IndustryModel","description":"The industry information"},"website":{"anyOf":[{"$ref":"#/components/schemas/Website"},{"type":"null"}],"description":"The website"},"address":{"$ref":"#/components/schemas/AddressModel","description":"The address information"},"annual_revenue":{"anyOf":[{"$ref":"#/components/schemas/AnnualRevenue"},{"type":"null"}],"description":"The annual revenue"},"employees_nb":{"anyOf":[{"$ref":"#/components/schemas/EmployeesNbModel"},{"type":"null"}],"description":"The employee number information"},"source":{"type":"string","title":"Source","description":"The source URL"},"company_type":{"$ref":"#/components/schemas/CompanyTypeModel","description":"The company type information"},"date":{"$ref":"#/components/schemas/DateModel","description":"The date information"},"legal_id_type":{"$ref":"#/components/schemas/LegalIDType","description":"The legal ID type"},"legal_id":{"type":"string","title":"Legal Id","description":"The legal ID"}},"type":"object","required":["score","account_name","industry","address","source","company_type","date","legal_id_type","legal_id"],"title":"LegalIDSuggestion","description":"Model representing a suggestion for a legal ID."},"IndustryModel":{"properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value","description":"The industry value"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"The industry description"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","description":"The industry type"}},"type":"object","title":"IndustryModel","description":"Model representing industry information."},"Website":{"properties":{"url":{"type":"string","title":"Url","description":"The URL of the website."}},"type":"object","required":["url"],"title":"Website","description":"Model representing a website containing a URL."},"AddressModel":{"properties":{"data_type":{"$ref":"#/components/schemas/DataType","description":"The type of data for this field"},"normalized_value":{"$ref":"#/components/schemas/AddressOutput","description":"Normalized address value."},"label":{"type":"string","enum":["No","Ok","Unknown"],"title":"Label","description":"Label for the address."},"scores":{"$ref":"#/components/schemas/ScoresModel","description":"Scores for the field"},"recommendations":{"items":{"$ref":"#/components/schemas/AddressRecommendation"},"type":"array","title":"Recommendations","description":"Recommendations for the address."}},"type":"object","required":["data_type","normalized_value","label","scores","recommendations"],"title":"AddressModel","description":"Model representing the details of an address field."},"AddressOutput":{"properties":{"street_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Street Number","description":"The street number"},"place_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Name","description":"The place name"},"street":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Street","description":"The street"},"full_street":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Street","description":"The full street"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"The city"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State","description":"The state"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code","description":"The zip code"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"The country"}},"type":"object","title":"AddressOutput","description":"Model representing an address."},"AddressRecommendation":{"properties":{"address":{"$ref":"#/components/schemas/AddressOutput","description":"Recommended address value."},"score":{"type":"number","maximum":1,"minimum":0,"title":"Score","description":"Confidence score for the recommendation."}},"type":"object","required":["address","score"],"title":"AddressRecommendation","description":"Model representing a recommendation for an address."},"AnnualRevenue":{"properties":{"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"title":"Value","description":"Annual revenue value (exact amount in USD)"},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Time of the annual revenue"},"profit":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"title":"Profit","description":"Profit of the annual revenue (exact amount in USD)"},"range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Range","description":"The annual revenue range"}},"type":"object","title":"AnnualRevenue","description":"Model representing an annual revenue."},"EmployeesNbModel":{"properties":{"value":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Value","description":"The employee number value"},"min":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min","description":"The minimum number of employees"},"max":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max","description":"The maximum number of employees"},"range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Range","description":"The employee range"}},"type":"object","title":"EmployeesNbModel","description":"Model representing employee number information."},"CompanyTypeModel":{"properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value","description":"The company type value"},"legal_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Type","description":"The legal type"},"legal_id_type_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Id Type Label","description":"The legal ID type label"},"legal_type_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Type Code","description":"The legal type code"}},"type":"object","title":"CompanyTypeModel","description":"Model representing company type information."},"DateModel":{"properties":{"creation_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creation Date","description":"The creation date"},"closing_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Closing Date","description":"The closing date"},"birth_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Birth Date","description":"The birth date"}},"type":"object","title":"DateModel","description":"Model representing date information."}}},"paths":{"/v1/legal-id/{job_id}":{"get":{"tags":["Legal ID"],"summary":"Get legal ID finder and validator job status","description":"Retrieve the result and status of a previously submitted legal ID finder and validator job.","operationId":"getLegalIDResult","responses":{"200":{"description":"Job succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegalIDPullOutput"}}}},"202":{"description":"Job is still running.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegalIDPullOutput"}}}},"400":{"description":"Input validation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegalIDPullOutput"}}}},"401":{"description":"Authentication failed - invalid or missing OAuth 2.0 token","content":{"application/json":{"schema":{"properties":{"message":{"type":"string"}},"type":"object"}}}},"500":{"description":"Failed to retrieve job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegalIDPullOutput"}}}},"504":{"description":"Job timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegalIDPullOutput"}}}}}}}}}
```


---

# Agent Instructions: 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:

```
GET https://help.delpha.io/delpha-api-and-mcp/api/legal-id.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.