> ## Documentation Index > Fetch the complete documentation index at: https://docs.valendata.com/llms.txt > Use this file to discover all available pages before exploring further. # Get an async skill run > Read an async run's status and, once it has finished, its rows. ## OpenAPI ````yaml GET /v1/runs/{run_id} openapi: 3.0.3 info: title: Valendata REST API version: 1.0.0 description: >- Trigger Skills, manage Workflows, retrieve Runs, and stream structured results from any language using JSON over HTTPS. servers: - url: https://api.valendata.com description: Production security: - ApiKeyAuth: [] tags: - name: Skills description: Execute and inspect published Skills. - name: Workflows description: Trigger multi-step Workflows and list them. - name: Runs description: Start async Skill runs and read Skill and Workflow run results. - name: Skill creation description: Create a Skill from a plain-language task. - name: Skill improvement description: >- Fix a Skill, add fields to it or re-learn its detail steps, poll the result, and read its change history. - name: Versions description: List, diff, restore, and pin a Skill's recipe versions. - name: Webhooks description: Signed delivery of finished async runs. paths: /v1/runs/{run_id}: get: tags: - Runs summary: Get an async Skill run description: >- Status while it runs, and the result once it is done. Rows are in `rows`. Readable by whoever started the run and by the Skill's owner. operationId: getSkillRun parameters: - name: run_id in: path required: true schema: type: string example: run_8c1d2e3f4a5b responses: '200': description: The run. content: application/json: schema: $ref: '#/components/schemas/SkillRunStatus' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' security: - ApiKeyAuth: [] components: schemas: SkillRunStatus: type: object properties: run_id: type: string status: type: string enum: - queued - running - success - partial - failed - cancelled skill_id: type: string nullable: true skill_slug: type: string nullable: true created_at: type: string format: date-time nullable: true execution_time_ms: type: integer count: type: integer error: type: string nullable: true rows: type: array items: type: object additionalProperties: true description: The rows, once the run has finished. credits_charged: type: integer description: Credits this run cost. cost_usd: type: number description: The same cost in US dollars. cost_final: type: boolean description: >- 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: type: integer description: >- `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: type: object additionalProperties: type: string description: Fields that look wrong on this run, with the reason. unverified_fields: type: object additionalProperties: type: string description: Fields not yet proven to be read correctly, with the reason. rejected_values: type: array items: type: object additionalProperties: true description: >- Values removed because they did not appear on the page: `{field, value, reason}`. truncated_sections: type: array items: type: object additionalProperties: true description: >- Sections that had more data than this run collected: `{section, clicks}`. scrape_mode_used: type: string nullable: true description: '`flash` or `deep` for skills that support scrape modes, else null.' triage_kind: type: string nullable: true enum: - ok - site_down - blocked - logged_out - page_not_loaded - element_changed - extraction_drift - unknown - null description: Why the run failed, or `ok`. recipe_version: type: integer nullable: true description: The recipe version this run replayed. heal_kind: type: string nullable: true enum: - fp - ai - null description: The repair that became the recipe during this run, if any. tier_used: type: string nullable: true enum: - fetch_direct - fetch_browser - replay - null description: Which route answered. tier_timings: type: array items: type: object additionalProperties: true description: 'Every route tried: `{tier, ok, seconds, reason}`.' diagnosis: allOf: - $ref: '#/components/schemas/Diagnosis' nullable: true description: >- Present when the run failed or a field came back on fewer than half the rows. needs_user: $ref: '#/components/schemas/NeedsUser' Diagnosis: type: object description: >- Why a run, validation or creation came back short, and hints that could fix it with `POST /v1/skills/{slug}/improve`. properties: rows: type: integer missing_fields: type: array items: type: string description: Fields fewer than half the rows came back with. per_field: type: object additionalProperties: $ref: '#/components/schemas/FieldDiagnosis' triage_kind: type: string nullable: true example: missing_fields what_we_tried: type: array items: type: string suggested_hint_examples: type: array items: type: string error: type: string nullable: true summary: type: string example: 'phone: found on 0/5 rows — tried the result cards' NeedsUser: type: object nullable: true description: >- 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. properties: kind: type: string enum: - no_login - bad_password - otp_email - otp_sms - captcha message: type: string description: What to do, in plain words. action_url: type: string description: Where it is fixed in the app (the Vault). example: /vault Error: type: object properties: detail: oneOf: - type: string - type: object additionalProperties: true description: >- Error message. Usually a plain string; may be a structured object for some errors. example: detail: Invalid or expired API key FieldDiagnosis: type: object properties: filled: type: string example: 0/5 description: Rows that had the field. filled_count: type: integer total: type: integer where_tried: type: array items: type: string example: - the result cards - each row's details page evidence: type: string example: blank on all 5 rows responses: Unauthorized: description: >- Unauthorized. The Authorization header is missing, malformed, or the credential is invalid or expired. content: application/json: schema: $ref: '#/components/schemas/Error' Forbidden: description: >- Forbidden. You may not run or change this Skill, or it is not published or active. content: application/json: schema: $ref: '#/components/schemas/Error' NotFound: description: Resource not found in your Workspace. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: vd_sk_... description: >- API key with the `vd_sk_` prefix. Create keys from Settings, API Keys in the dashboard. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.