# Welcome to Dealsignal

> Enrich, refresh, and validate contact and company data at scale.

DealSignal provides fresh, accurate, verified B2B data so sales and marketing teams can target the right buyers, personalize outreach, and increase deliverability.

This site has three sections:

#### [Documentation](/documentation/lead-enrichment/overview)

Concepts, flows, and quickstarts for each product area.

#### [API Reference](/api-reference)

Every endpoint with request/response schemas and live examples.

#### [What's New](/whats-new)

Recently shipped endpoints and breaking-change notes.

---

## Base URL

```
https://app.dealsignal.com
```

## Authentication in one line

Every request except the key-roll endpoint takes your `api_key` as a query parameter:

```bash
curl "https://app.dealsignal.com/api/v1/users/credit_metrics?api_key=YOUR_API_KEY"
```

For details on rotation, grace windows, and the `POST /api/v1/auth/api_keys/roll` endpoint, see **[Authentication](/documentation/get-started/authentication)**.

---

## Product areas

#### [Lead Enrichment](/documentation/lead-enrichment/overview)

Submit a bulk list of contacts; receive verified emails, phones, titles, company data.

#### [Contact Profile Refresh Requests](/documentation/contact-profile-refresh-requests/overview)

Refresh individual profiles on demand. By default every profile comes back inline with the contact matched so far; poll for the refreshed results.

#### [Credits](/documentation/credits/overview)

Check your credit balance and usage before launching jobs.

> Enrich, refresh, and validate contact and company data at scale.

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.dealsignal.com/_mcp/server

## Docs

- [Welcome to Dealsignal](https://docs.dealsignal.com/.md): Enrich, refresh, and validate contact and company data at scale.
- [Authentication](https://docs.dealsignal.com/documentation/get-started/authentication.md): How to authenticate, rotate, and manage your Dealsignal API keys.
- [Lead Enrichment Overview](https://docs.dealsignal.com/documentation/lead-enrichment/overview.md): Submit a bulk list of contacts; receive verified emails, phones, titles, and company data.
- [Contact Profile Refresh Requests Overview](https://docs.dealsignal.com/documentation/contact-profile-refresh-requests/overview.md): Refresh individual contact profiles on demand — every profile comes back inline with the contact matched so far; poll for the rest.
- [Credits Overview](https://docs.dealsignal.com/documentation/credits/overview.md): Check your credit balance and today's profile-request volume.
- [2026-09-17 — Contact Profile Refresh Requests: change-detection fields (`ds_*`)](https://docs.dealsignal.com/whats-new/2026-09-17-cprr-change-detection.md): `response_format=changes` now carries the `ds_*` change-detection fields; the beta `changes[]` key is gone; `changed_company` / `changed_title` compare the primary position with the previous snapshot.
- [2026-05-20 — API key rotation & Authentication tag](https://docs.dealsignal.com/whats-new/2026-05-20-auth-endpoints.md): New `/api/v1/auth/api_keys` endpoints for zero-downtime key rotation.

## API Docs

- API Reference > Lead Enrichment [List LE jobs](https://docs.dealsignal.com/api-reference/lead-enrichment/list-lead-enrichment-jobs.md)
- API Reference > Lead Enrichment [Create and launch an LE job](https://docs.dealsignal.com/api-reference/lead-enrichment/create-lead-enrichment-job.md)
- API Reference > Lead Enrichment [Get LE job status](https://docs.dealsignal.com/api-reference/lead-enrichment/get-lead-enrichment-job.md)
- API Reference > Lead Enrichment [Get final results](https://docs.dealsignal.com/api-reference/lead-enrichment/get-lead-enrichment-final-result.md)
- API Reference > Contact Profile Refresh Requests [Create a Contact Profile Refresh Request](https://docs.dealsignal.com/api-reference/contact-profile-refresh-requests/create-contact-profile-refresh-request.md)
- API Reference > Contact Profile Refresh Requests [Get a Contact Profile Refresh Request](https://docs.dealsignal.com/api-reference/contact-profile-refresh-requests/get-contact-profile-refresh-request.md)
- API Reference > Contact Profile Refresh Requests [Contact Profile Refresh Request completed (webhook)](https://docs.dealsignal.com/api-reference/contact-profile-refresh-requests/contact-profile-refresh-request-completed.md)
- API Reference > Credits [Get credit metrics](https://docs.dealsignal.com/api-reference/credits/get-credit-metrics.md)
- API Reference > Authentication [List API keys](https://docs.dealsignal.com/api-reference/authentication/list-api-keys.md)
- API Reference > Authentication [Roll API key](https://docs.dealsignal.com/api-reference/authentication/roll-api-key.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.dealsignal.com/openapi.json)
- [OpenAPI YAML](https://docs.dealsignal.com/openapi.yaml)