Skip to main content
GET
Get an async Skill run

Authorizations

Authorization
string
header
required

API key with the vd_sk_ prefix. Create keys from Settings, API Keys in the dashboard.

Path Parameters

run_id
string
required

Response

The run.

run_id
string
status
enum<string>
Available options:
queued,
running,
success,
partial,
failed,
cancelled
skill_id
string | null
skill_slug
string | null
created_at
string<date-time> | null
execution_time_ms
integer
count
integer
error
string | null
rows
object[]

The rows, once the run has finished.

credits_charged
integer

Credits this run cost.

cost_usd
number

The same cost in US dollars.

cost_final
boolean

False while the run's cloud browser time is still being billed (the browser is billed when it closes, which can be after the run answers). credits_charged is then only what has been billed so far. True once nothing more will be charged.

cost_estimate_credits
integer

credits_charged plus an estimate of the browser time still being billed, at the current browser rate. Equal to credits_charged once cost_final is true.

drifted_fields
object

Fields that look wrong on this run, with the reason.

unverified_fields
object

Fields not yet proven to be read correctly, with the reason.

rejected_values
object[]

Values removed because they did not appear on the page: {field, value, reason}.

truncated_sections
object[]

Sections that had more data than this run collected: {section, clicks}.

scrape_mode_used
string | null

flash or deep for skills that support scrape modes, else null.

triage_kind
enum<string> | null

Why the run failed, or ok.

Available options:
ok,
site_down,
blocked,
logged_out,
page_not_loaded,
element_changed,
extraction_drift,
unknown,
null
recipe_version
integer | null

The recipe version this run replayed.

heal_kind
enum<string> | null

The repair that became the recipe during this run, if any.

Available options:
fp,
ai,
null
tier_used
enum<string> | null

Which route answered.

Available options:
fetch_direct,
fetch_browser,
replay,
null
tier_timings
object[]

Every route tried: {tier, ok, seconds, reason}.

diagnosis
object | null

Present when the run failed or a field came back on fewer than half the rows.

needs_user
object | null

Set when a login stopped the run: what the skill's owner has to fix. Kind and fixed words only — never a username, password or code.