DiscoLike: Get Contacts Run

Read the status, spend, and a page of companies with their validated contacts for a contacts run started by discolike_find_contacts.

Tool ID: discolike_get_contacts_run

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'discolike_get_contacts_run',
  {
    "run_id": "123e4567-e89b-42d3-a456-426614174000"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline run discolike_get_contacts_run --input '{
  "run_id": "123e4567-e89b-42d3-a456-426614174000"
}'

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "id": "id_123",
    "kind": "example",
    "status": "example",
    "generation": 123,
    "created_at": "2026-01-15T12:00:00Z",
    "updated_at": "2026-01-15T12:00:00Z",
    "expires_at": "2026-01-15T12:00:00Z"
  }
}

Use deepline describe discolike_get_contacts_run --json for the latest machine-readable contract.

Input reference

Returns live status, delivery spend and a page of results. For contacts runs, rows_offset and rows_limit page companies. Each includes its live status and validated contacts. Poll while running. summary totals cover the whole run on completion or cancellation.

Name	Type	Required	Default	Details
`payload.run_id`	`string`	Yes	—	Format: `uuid`.
`payload.rows_offset`	`integer`	No	`0`	Minimum: 0.
`payload.rows_limit`	`integer`	No	`100`	Minimum: 1. Maximum: 1000.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.progress`	`record`	No	—	—
`result.data.applied_company_filters`	`object \| null`	No	—	Effective company filters after prompt extraction. absent until resolved.
`result.data.applied_company_filters.filter_industry`	`array \| null`	No	—	Filter by industry category (ANY-OF. prefix + to require a category). Valid values: ACCOUNTING, ADVERTISING_AND_MARKETING, AGRICULTURE_AND_NATURAL_RESOURCES, ALCOHOL_AND_TOBACCO, AUTOMOTIVE, BIG_DATA_AND_ANALYTICS, BIOTECHNOLOGY, BLOCKCHAIN_AND_CRYPTOCURRENCY, BUSINESS_PRODUCTS_AND_SERVICES, CLOUD_COMPUTING, COMPUTER_HARDWARE_AND_SEMICONDUCTORS, CONGLOMERATES_SHELL_AND_HOLDING_COMPANIES, CONSTRUCTION, CONSUMER_PRODUCTS, CONSUMER_SERVICES, CYBERSECURITY, DEFENSE_AND_AEROSPACE, E-COMMERCE, See the live schema for the complete constraint.
`result.data.applied_company_filters.negate_filter_industry`	`array \| null`	No	—	Exclude contacts at companies in specified industries. Valid values: ACCOUNTING, ADVERTISING_AND_MARKETING, AGRICULTURE_AND_NATURAL_RESOURCES, ALCOHOL_AND_TOBACCO, AUTOMOTIVE, BIG_DATA_AND_ANALYTICS, BIOTECHNOLOGY, BLOCKCHAIN_AND_CRYPTOCURRENCY, BUSINESS_PRODUCTS_AND_SERVICES, CLOUD_COMPUTING, COMPUTER_HARDWARE_AND_SEMICONDUCTORS, CONGLOMERATES_SHELL_AND_HOLDING_COMPANIES, CONSTRUCTION, CONSUMER_PRODUCTS, CONSUMER_SERVICES, CYBERSECURITY, DEFENSE_AND_AEROSPACE, E-COMMERCE, EDUCATION, ENERGY, See the live schema for the complete constraint.
`result.data.applied_company_filters.filter_country`	`array \| null`	No	—	Filter by company country using ISO-3166-1 alpha-2 codes (e.g., US, GB, DE). Also accepts region aliases: EU, LATAM, MENA, APAC, NORDICS, DACH, BENELUX, GCC, ASEAN, CEE, ANZ, EUROPE, ASIA, AFRICA, NORTH_AMERICA, SOUTH_AMERICA, OCEANIA, ANTARCTICA.
`result.data.applied_company_filters.negate_filter_country`	`array \| null`	No	—	Exclude contacts at companies in specified countries. Accepts same codes and region aliases as filter_country.
`result.data.applied_company_filters.filter_state`	`array \| null`	No	—	Filter by company state/region. Accepts ISO 3166-2 codes or names, listed at https://docs.discolike.com/states/, resolved against the selected countries. A value that resolves under none is ignored.
`result.data.applied_company_filters.negate_filter_state`	`array \| null`	No	—	Exclude contacts at companies in specified states. Same format as filter_state.
`result.data.applied_company_filters.employee_range`	`string \| null`	No	—	Filter by employee count range. Format: ‘min,max’ (e.g., ‘51,200’). Maps to buckets: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.
`result.data.applied_company_filters.revenue_range`	`string \| null`	No	—	Company revenue range as ‘min,max’ in raw numbers, e.g. ‘10000000,50000000’.
`result.data.applied_company_filters.sub_industry`	`array \| null`	No	—	Only include companies in these sub-industries.
`result.data.error`	`string \| null`	No	—	—
`result.data.input`	`record`	No	—	—
`result.data.id`	`string`	Yes	—	—
`result.data.kind`	`string`	Yes	—	—
`result.data.status`	`string`	Yes	—	—
`result.data.current_step`	`"find_contacts" \| "find_missing" \| "find_emails" \| "discover" \| "validate"`	No	—	Allowed: `find_contacts`, `find_missing`, `find_emails`, `discover`, `validate`.
`result.data.generation`	`integer`	Yes	—	—
`result.data.steps`	`record`	No	—	—
`result.data.total_estimate_usd`	`string \| null`	No	—	—
`result.data.total_charged_usd`	`string`	No	`"0"`	—
`result.data.created_at`	`string`	Yes	—	Format: `date-time`.
`result.data.updated_at`	`string`	Yes	—	Format: `date-time`.
`result.data.expires_at`	`string`	Yes	—	Format: `date-time`.
`result.data.companies`	`array`	No	—	—
`result.data.companies[].company`	`record`	No	—	—
`result.data.companies[].domain`	`string`	Yes	—	—
`result.data.companies[].status`	`"pending" \| "finding_people" \| "finding_emails" \| "validated" \| "skipped" \| "cancelled" \| "failed"`	Yes	—	Allowed: `pending`, `finding_people`, `finding_emails`, `validated`, `skipped`, `cancelled`, `failed`.
`result.data.companies[].people_reviewed`	`integer`	No	`0`	—
`result.data.companies[].mailboxes_checked`	`integer`	No	`0`	—
`result.data.companies[].validated_contacts`	`integer`	No	`0`	—
`result.data.companies[].contacts`	`array`	No	—	—
`result.data.companies[].contacts[].row_key`	`string`	Yes	—	—
`result.data.companies[].contacts[].persona_id`	`integer \| null`	No	—	—
`result.data.companies[].contacts[].domain`	`string`	Yes	—	—
`result.data.companies[].contacts[].name`	`string \| null`	No	—	—
`result.data.companies[].contacts[].title`	`string \| null`	No	—	—
`result.data.companies[].contacts[].linkedin_url`	`string \| null`	No	—	—
`result.data.companies[].contacts[].seniority`	`string \| null`	No	—	—
`result.data.companies[].contacts[].department`	`string \| null`	No	—	—
`result.data.companies[].contacts[].debug_only`	`boolean \| null`	No	—	—
`result.data.companies[].contacts[].reason`	`string \| null`	No	—	—
`result.data.companies[].contacts[].company_score`	`number \| null`	No	—	—
`result.data.companies[].contacts[].p_fit`	`number \| null`	No	—	—
`result.data.companies[].contacts[].fit_label`	`string \| null`	No	—	—
`result.data.companies[].contacts[].floor`	`boolean`	No	`false`	—
`result.data.companies[].contacts[].not_fit`	`boolean`	No	`false`	—
`result.data.companies[].contacts[].email`	`string \| null`	No	—	—
`result.data.companies[].contacts[].email_status`	`string \| null`	No	—	—

The table shows the first 50 fields. Use the live contract below for every field.

This output schema is too large for an inline display. Read the complete live contract with deepline describe discolike_get_contacts_run --json.

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation