Enrichments

Entity-first alias of POST /v1/companies/signals (Phase 2): the same research engine, cache, and price, returning the enrichment_run envelope instead of the bare signal.

Completion semantics

• If the run is already complete when the request returns (served from the shared answer cache), the response is 200 with the result inline.
• A fresh run returns 202 Accepted with Location: /v1/enrichment-runs/{runId} — poll that resource (or supply a webhookUrl). This surface never long-polls; callers who want blocking behaviour keep POST /v1/companies/signals/sync until its sunset.

Entity-first means the identifier is fixed by the route: domain is required and contactProfileUrl is rejected here.

Webhook payload: webhookUrl uses the same delivery path as /v1/companies/signals, so the callback body is the legacy signal shape (top-level answer, no run fields) — not the enrichment_run envelope. A run-shaped webhook payload arrives with the sunset plan (SEL-3685); until then, poll /v1/enrichment-runs/{runId} for the run shape.

Credits

Same pricing as POST /v1/companies/signals: 2 credits per run, repeat calls served from the cache do not consume additional credits, and failed runs are never charged. The run's credits block (on run reads) states what your organization was actually charged.

{  "yes": "good",  "no": "disqualified"}

{  "ranges": [    { "rangeStart": 0, "rangeEnd": 100, "answerValue": "neutral" },    { "rangeStart": 101, "rangeEnd": 1000, "answerValue": "good" }  ]}

{  "choices": {    "salesforce": { "answerValue": "good", "label": "Salesforce" },    "hubspot": { "answerValue": "neutral", "label": "HubSpot" },    "none": { "answerValue": "disqualified", "label": "No CRM" }  }}

Response Body

One shared question applied to a targets array of domains — one enrichment_run per target, no question × company expansion (unlike the legacy /v1/companies/signals/batch). Capped at 100 targets; larger workloads stay on the legacy async batch surface. Either question or signalTemplateId must be provided.

Webhook payload: webhookUrl uses the same delivery path as /v1/companies/signals, so each callback body is the legacy signal shape (top-level answer, no run fields) — not the enrichment_run envelope. A run-shaped webhook payload arrives with the sunset plan (SEL-3685).

Credits

2 credits per run (per target), success-only, cached results free — identical to single custom enrichment.

Response Body

Entity-first alias of POST /v1/contacts/signals: same engine, cache, and price, enrichment_run envelope on the wire. The identifier is fixed by the route: contactProfileUrl is required and domain is rejected here. Completion semantics match the company surface (200 inline on cache serve, 202 + Location for fresh runs).

Webhook payload: webhookUrl uses the same delivery path as /v1/contacts/signals, so the callback body is the legacy signal shape (top-level answer, no run fields) — not the enrichment_run envelope. A run-shaped webhook payload arrives with the sunset plan (SEL-3685); until then, poll /v1/enrichment-runs/{runId} for the run shape.

Credits

2 credits per run; cached repeats free; failed runs never charged.

Response Body

Prebuilt enrichment: company profile, refined category, and customer segments — the same research contract as POST /v1/signals/firmographics, on the entity-first surface with the enrichment_run envelope and its completion semantics (200 inline on a cache serve, 202 + Location: /v1/enrichment-runs/{runId} for a fresh run). The completed result conforms to FirmographicsSignalAnswer.

Webhook payload: webhookUrl delivers the legacy signal shape (top-level answer, no run fields), and its namedSignal field carries the internal catalogue key (firmographics here; tech for tech-stack), not this surface's type vocabulary. The webhook moves to the run shape with the sunset plan (SEL-3685); until then poll /v1/enrichment-runs/{runId} for the public shape.

Credits

0.6 credits, charged once per result delivered to your organization. Repeat calls served from the cache are free — including results your organization already paid for via the legacy signals surface — and failed runs are never charged.

Response Body

Prebuilt enrichment: a company's most recent funding and public/IPO status — the same research contract as POST /v1/signals/funding, on the entity-first surface with the enrichment_run envelope and its completion semantics (200 inline on a cache serve, 202 + Location: /v1/enrichment-runs/{runId} for a fresh run). The completed result conforms to FundingSignalAnswer.

Webhook payload: webhookUrl delivers the legacy signal shape (top-level answer, no run fields), and its namedSignal field carries the internal catalogue key (funding here; tech for tech-stack), not this surface's type vocabulary. The webhook moves to the run shape with the sunset plan (SEL-3685); until then poll /v1/enrichment-runs/{runId} for the public shape.

Credits

0.3 credits, charged once per result delivered to your organization. Repeat calls served from the cache are free — including results your organization already paid for via the legacy signals surface — and failed runs are never charged.

Response Body

Prebuilt enrichment: a company's recent M&A activity, as acquirer or acquiree — the same research contract as POST /v1/signals/mna, on the entity-first surface with the enrichment_run envelope and its completion semantics (200 inline on a cache serve, 202 + Location: /v1/enrichment-runs/{runId} for a fresh run). The completed result conforms to MAndASignalAnswer.

Webhook payload: webhookUrl delivers the legacy signal shape (top-level answer, no run fields), and its namedSignal field carries the internal catalogue key (mna here; tech for tech-stack), not this surface's type vocabulary. The webhook moves to the run shape with the sunset plan (SEL-3685); until then poll /v1/enrichment-runs/{runId} for the public shape.

Credits

0.75 credits, charged once per result delivered to your organization. Repeat calls served from the cache are free — including results your organization already paid for via the legacy signals surface — and failed runs are never charged.

Response Body

Prebuilt enrichment: a company's current hiring — total open roles and example titles — the same research contract as POST /v1/signals/open-jobs, on the entity-first surface with the enrichment_run envelope and its completion semantics (200 inline on a cache serve, 202 + Location: /v1/enrichment-runs/{runId} for a fresh run). The completed result conforms to OpenJobsSignalAnswer.

Webhook payload: webhookUrl delivers the legacy signal shape (top-level answer, no run fields), and its namedSignal field carries the internal catalogue key (open-jobs here; tech for tech-stack), not this surface's type vocabulary. The webhook moves to the run shape with the sunset plan (SEL-3685); until then poll /v1/enrichment-runs/{runId} for the public shape.

Credits

0.5 credits, charged once per result delivered to your organization. Repeat calls served from the cache are free — including results your organization already paid for via the legacy signals surface — and failed runs are never charged.

Response Body

Prebuilt enrichment: which system(s) a company currently uses — the same research contract as POST /v1/signals/tech, on the entity-first surface with the enrichment_run envelope and its completion semantics (200 inline on a cache serve, 202 + Location: /v1/enrichment-runs/{runId} for a fresh run). Provide exactly one of category (survey a category: erp or crm) or technology (verify one specific technology). The completed result conforms to TechSignalAnswer.

Webhook payload: webhookUrl delivers the legacy signal shape (top-level answer, no run fields), and its namedSignal field carries the internal catalogue key — tech, not this surface's tech-stack — so it is NOT a value the type vocabulary admits. The webhook moves to the run shape with the sunset plan (SEL-3685); until then poll /v1/enrichment-runs/{runId} for the public shape.

Credits

0.75 credits, charged once per result delivered to your organization. Repeat calls served from the cache are free — including results your organization already paid for via the legacy signals surface — and failed runs are never charged.

Response Body

The email finder on the enrichment family (decision 16): the SAME lookup as POST /v1/contacts/find-email — identical request and response contract, same verification semantics, same 0.1-credit price. This rename is a name change, not a reprice. The legacy path keeps its 0.1-credit price until its announced sunset; use this route going forward.

See POST /v1/contacts/find-email for the full response semantics (status discriminator, catch-all handling, name parsing).

Credits

Each call charges 0.1 credits on success — both when a deliverable email is found and when no email is found (the verification attempt itself consumed work). Requests rejected before any verification work begins are not charged; insufficient balance returns 402 before any work is performed.

Response Body

Unified list across company and contact runs. Filters are the common fields only: entityType, status, fromDate/toDate (against the run's creation time), exact entityId (the resolved company id — contact runs carry no entity id at rest, so an entityId filter never matches them), and type (custom or a prebuilt enrichment type). No per-entity attribute filters by design; look a company up by id, not by domain.

Reads are free. Each run carries a credits block stating what your organization was charged for it — none means it was served free (for example a cache hit).

Query Parameters

Response Body

The run resource is the source of truth for async enrichment: poll it after a 202 (its path arrives in the Location header), or after a missed webhook. Free; includes the credits block.

Path Parameters

Response Body