Get Enrichment Status

Poll enrichment progress. No Temporal query needed — activities write progress to the DB directly.

GET /contacts/{contact_id}/enrich-status

Enrich Status

cURL

curl --request GET \
  --url https://api.example.com/contacts/{contact_id}/enrich-status \
  --header 'Authorization: Bearer <token>'

200

{}

Plain DB read of the contact row — no Temporal query. completed_steps/current_step are computed by unpacking enrichment_data.meta, which the workflow’s activities update after each pipeline step.

Auth

Requires a CRM read scope and an active organization on the token. Any of contacts:read, deals:read, companies:read, or activities:read qualifies, as does any *:manage scope — manage implies read.

Response

Field	Type	Description
status	string | null	enrichment_status column: pending, running, complete, failed, or null if never enriched.
completed_steps	array of string	From enrichment_data.meta.completed_steps, e.g. ["apollo_discovery", "scrapin_profile"]. [] if absent.
current_step	string | null	From enrichment_data.meta.current_step — one of apollo_discovery, scrapin_profile, hunter_verify, resolve_photo, or null when idle.
enriched_at	string (ISO 8601) | null
enrichment_data	object	The full raw blob — apollo, scrapin, hunter, meta namespaces, each present once that step has run.

Errors

Status	Cause
404	Contact not found.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

contact_id · string · required

The contact's id.

Response

200

application/json

Successful Response

The response is of type Response Enrich Status Route Contacts Contact Id Enrich Status Get · object.