> 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.md). # API REST API to find, validate and enrich business-identity data — emails, phones, names, websites, legal IDs, LinkedIn, ultimate parents. OpenAPI 3.1, API key/OAuth 2.0, signed webhooks, test mode. The Delpha Data Quality API brings clean, trusted customer data to your applications. It detects and fixes incomplete, inconsistent, duplicate, or invalid records, enriches missing fields, and enforces your data standards in real time or batch. Responses include actionable recommendations with confidence scores so you can automate safely and keep downstream systems accurate. ## Start here | | | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Base URL** | `https://api.delpha.io` | | **Authentication** | `Authorization: Bearer dlp_live_…` — create a key at [Developer → API keys](https://app.delpha.ai/developer/api-keys) ([sign up](https://app.delpha.ai/signup) first). OAuth 2.0 client credentials also work. See [Authentication](/delpha-api-and-mcp/api/authentication.md). | | **OpenAPI document** | [openapi.json](https://delpha-static-ressources.s3.eu-west-1.amazonaws.com/openapi.json) — OpenAPI 3.1, the whole contract: every operation, schema, error code, webhook event and per-operation extension. Every guide and endpoint page in this space is generated from it. | | **Try it for free** | Create the key in [Test mode](/delpha-api-and-mcp/api/test-mode.md): same endpoints and schemas, canned results, no credits spent. | | **For AI agents** | The same operations are tools on the hosted [Delpha MCP server](/delpha-api-and-mcp/mcp.md) at `https://mcp.delpha.ai/mcp`. | | **What changed** | [Changelog](/delpha-api-and-mcp/api/changelog.md) — one entry per version of the document. | Your first call submits a verification and returns **202** with a `job_id`, a `Location` header holding the poll URL and a `Retry-After`: ```bash curl -X POST https://api.delpha.io/v1/email \ -H "Authorization: Bearer dlp_live_your_key_here" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: 0c8f0d6e-5b1a-4d4e-9f0e-1234567890ab" \ -d '{"first_name": "Jordan", "last_name": "Rivera", "website": "delpha.io"}' ``` Poll the `Location` until it answers **200** with a `result`, or subscribe a [webhook](/delpha-api-and-mcp/api/webhooks.md) and skip polling. Every response — success or error — carries a machine-readable `code`, a `request_id`, and your remaining [rate-limit](/delpha-api-and-mcp/api/rate-limits.md) allowance. **Guides:** [Authentication](/delpha-api-and-mcp/api/authentication.md) · [Test mode](/delpha-api-and-mcp/api/test-mode.md) · [Request and response model](/delpha-api-and-mcp/api/request-and-response-model.md) · [Asynchronous verifications](/delpha-api-and-mcp/api/asynchronous-verifications.md) · [Pagination](/delpha-api-and-mcp/api/pagination.md) · [Idempotency](/delpha-api-and-mcp/api/idempotency.md) · [Batch operations](/delpha-api-and-mcp/api/batch-operations.md) · [Rate limits](/delpha-api-and-mcp/api/rate-limits.md) · [Errors](/delpha-api-and-mcp/api/errors.md) · [Webhooks](/delpha-api-and-mcp/api/webhooks.md) · [Credits](/delpha-api-and-mcp/api/credits.md) · [Versioning and deprecation](/delpha-api-and-mcp/api/versioning-and-deprecation.md) · [Changelog](/delpha-api-and-mcp/api/changelog.md) ## Delpha API catalog **Public API** rows are callable today at `https://api.delpha.io` — click the name for the endpoint reference. **Not on the public API** rows are capabilities of the Delpha platform that are not exposed on this API. ### **Company / Account APIs** | API Name | Objective | Availability | Description | | ------------------------------------------------------------------------------- | --------- | --------------------- | ------------------------------------------------------------------------------------------------------------ | | [Company Search](/delpha-api-and-mcp/api/company.md) | Find | Public API | Search Delpha's company datalake by name, legal ID or free text — typed records, filters, cursor pagination. | | [Company Phone Finder](/delpha-api-and-mcp/api/phone.md) | Recommend | Public API | Finds company phone numbers. | | [Company Website Finder](/delpha-api-and-mcp/api/website.md) | Recommend | Public API | Finds official company websites. | | [Company LinkedIn Finder](/delpha-api-and-mcp/api/linked-in-company-page.md) | Recommend | Public API | Finds a company's LinkedIn page. | | [Company Legal ID Finder](/delpha-api-and-mcp/api/legal-id.md) | Recommend | Public API | Finds a company's legal identifier (e.g., SIREN, KVK, EIN). | | [Company Ultimate Parent Finder](/delpha-api-and-mcp/api/ultimate-parent.md) | Recommend | Public API | Identifies the ultimate parent of a company. | | [Company Phone Validator](/delpha-api-and-mcp/api/phone.md) | Validate | Public API | Validates company phone numbers. | | Company [Website](/delpha-api-and-mcp/api/website.md) Validator | Validate | Public API | Validates correctness and activity of company websites. | | [Company LinkedIn Validator](/delpha-api-and-mcp/api/linked-in-company-page.md) | Validate | Public API | Validates a company's LinkedIn page. | | [Company Legal ID Validator](/delpha-api-and-mcp/api/legal-id.md) | Validate | Public API | Validates the correctness of a company's legal ID. | | [Company Ultimate Parent Validator](/delpha-api-and-mcp/api/ultimate-parent.md) | Validate | Public API | Validates an identified ultimate parent relationship. | | Company Address Finder | Recommend | Not on the public API | Retrieves a company's registered or operational addresses. | | Company Address Validator | Validate | Not on the public API | Validates and normalizes company addresses. | | Company Data Enrichment | Enrich | Not on the public API | Enriches company profiles with external and internal data sources. | | Company LinkedIn Import | Enrich | Not on the public API | Imports accounts from a LinkedIn or Sales Navigator search or list. | | Company Data Quality Score | Score | Not on the public API | Returns a quality score for company data across multiple dimensions. | ### **Contact APIs** | API Name | Objective | Availability | Description | | -------------------------------------------------------------------------- | --------- | --------------------- | -------------------------------------------------------------------- | | [Contact Email Finder](/delpha-api-and-mcp/api/email.md) | Recommend | Public API | Finds contact email addresses. | | [Contact LinkedIn Finder](/delpha-api-and-mcp/api/linked-in-profile.md) | Recommend | Public API | Finds a contact's LinkedIn profile. | | [Contact Phone Validator](/delpha-api-and-mcp/api/phone.md) | Validate | Public API | Validates contact phone numbers. | | [Contact Email Validator](/delpha-api-and-mcp/api/email.md) | Validate | Public API | Validates the correctness of contact emails. | | [Contact LinkedIn Validator](/delpha-api-and-mcp/api/linked-in-profile.md) | Validate | Public API | Validates a contact's LinkedIn profile. | | [Contact Name Validator](/delpha-api-and-mcp/api/name.md) | Validate | Public API | Validates and normalizes contact names. | | Contact Job History Finder | Recommend | Not on the public API | Retrieves job history of a contact. | | Contact Address Validator | Validate | Not on the public API | Validates and normalizes contact addresses. | | Contact Job Title Validator | Validate | Not on the public API | Validates a contact's job title. | | Contact Current Account Validator | Validate | Not on the public API | Validates the link between a contact and their current account. | | Contact Data Enrichment | Enrich | Not on the public API | Enriches contact profiles with additional attributes. | | Contact Email Insights | Enrich | Not on the public API | Extracts insights from contact emails (e.g., OOO, job changes). | | Contact LinkedIn Import | Enrich | Not on the public API | Imports contacts from a LinkedIn or Sales Navigator search or list. | | Contact Data Quality Score | Score | Not on the public API | Returns a quality score for contact data across multiple dimensions. | ### **Duplicate Management APIs** | API Name | Objective | Availability | Description | | ---------------- | --------- | --------------------- | ---------------------------------------------------------- | | Duplicate Finder | Recommend | Not on the public API | Detects potential duplicate records. | | Duplicate Score | Score | Not on the public API | Assigns a score to measure record duplication probability. | | Duplicate Merge | Merge | Not on the public API | Merges duplicate records. | --- # 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.md?ask=&goal= ``` `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.