Skip to main content

​
POST /api/v1/bd/jobs

Create a BD enrichment job. You can specify a preset for common pipeline configurations, or provide an explicit requested_capabilities list for custom pipelines. Returns 202 Accepted with the created job record. Use GET /api/v1/bd/jobs/{job_id} to poll status.
Requires an active paid subscription.

​
Presets

PresetDescription
full_pipelineFull contact discovery: qualification → company size → contact discovery → email lookup → email verify
verify_existing_emailsVerify deliverability of contacts you supply
company_size_and_email_verifyDetermine company size and verify email deliverability
enrich_contacts_from_companiesDiscover and enrich contacts from a company list

​
Capabilities

If you omit preset, provide one or more capabilities explicitly:
CapabilityDescription
qualificationFilter and qualify input companies or contacts
company_sizeDetermine employee headcount
contact_discoveryFind contacts at input companies
email_lookupFind email addresses for contacts
email_verifyVerify email deliverability
linkedin_enrichEnrich profiles with LinkedIn data
deliverable_finalizeFinalise and deduplicate deliverable contacts

​
Request body

​
preset
string
One of full_pipeline, verify_existing_emails, company_size_and_email_verify, or enrich_contacts_from_companies. Mutually exclusive with requested_capabilities.
​
requested_capabilities
array
Explicit list of capability strings. Used when preset is not set.
​
input_assets
object
Input records to process.
​
icp_config
object
ICP (Ideal Customer Profile) qualification criteria. Used when icp_gate is "apply".
​
execution_options
object
Fine-grained execution controls.
​
chat_id
string
UUID of a chat to associate this job with.

​
Response

Returns 202 Accepted.
​
job_id
string
UUID of the created BD job.
​
status
string
Always "pending" immediately after creation.
​
progress_percent
integer
Always 0 at creation.
​
preset
string
The resolved preset name.
​
requested_capabilities
array
Capabilities the planner resolved for this job.
​
warnings
array
Non-fatal planning warnings.
​
created_at
string
ISO 8601 creation timestamp.

​
Example

cURL
curl -X POST https://api.deepcurrent.app/api/v1/bd/jobs \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "preset": "full_pipeline",
    "input_assets": {
      "companies": [
        { "company_name": "Uniswap Labs", "website": "https://uniswap.org" },
        { "company_name": "Aave", "domain": "aave.com" }
      ]
    },
    "execution_options": {
      "niche": "defi",
      "icp_gate": "skip"
    }
  }'
Response
{
  "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "pending",
  "progress_percent": 0,
  "progress_message": "Queued for execution",
  "preset": "full_pipeline",
  "requested_capabilities": [
    "qualification",
    "contact_discovery",
    "email_lookup",
    "email_verify",
    "deliverable_finalize"
  ],
  "warnings": [],
  "error_message": null,
  "created_at": "2026-04-08T12:00:00Z",
  "updated_at": "2026-04-08T12:00:00Z",
  "started_at": null,
  "completed_at": null
}