> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# WizLeads: Get Task

> Check a scraping or email task's status and progress by task ID, and get its results as CSV. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

Check a scraping or email task's status and progress by task ID, and get its results as CSV.

> [!NOTE]
>
> Tool ID: `wizleads_get_task`

## 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.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'wizleads_get_task',
  {
    "task_id": "task_123"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute wizleads_get_task --input '{
  "task_id": "task_123"
}' --json
```

## Example response

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

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "id": "id_123",
    "name": "Example",
    "creator": "example"
  }
}
```

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

## Input reference

Check status and live progress of a running task, and download the results in CSV format.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.task_id` | `string` | Yes | — | — |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Check status and live progress of a running task, and download the results in CSV format.",
    "properties": {
      "task_id": {
        "type": "string"
      }
    },
    "required": [
      "task_id"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.id` | `string` | No | — | Task ID. |
| `result.data.name` | `string` | No | — | Task name. |
| `result.data.creator` | `string` | No | — | Username (email) of task creator. |
| `result.data.created` | `string` | No | — | Timestamp of task creation. |
| `result.data.type` | `"salesnav-profile" \| "salesnav-company" \| "find-email" \| "verify-email"` | No | — | Type of scraping task. Allowed: `salesnav-profile`, `salesnav-company`, `find-email`, `verify-email`. |
| `result.data.inputs` | `object` | No | — | Input parameters for the task. All parameters are not given for all task types. Task List contains less information than Task Detail. |
| `result.data.inputs.accounts` | `array \| null` | No | — | List of account IDs to use. Set to null for automatic selection. Only available when useAccountless is false. |
| `result.data.inputs.links` | `array` | No | — | List of Sales Navigator search URLs to scrape. |
| `result.data.inputs.links[].id` | `integer` | No | — | Numeric ID assigned to each link, unique to this task. |
| `result.data.inputs.links[].link` | `string` | No | — | A Sales Navigator search URL. |
| `result.data.inputs.links[].end_page` | `number \| null` | No | `null` | — |
| `result.data.inputs.links[].count` | `integer \| null` | No | — | Number of results present on this link. |
| `result.data.inputs.links[].count_scrapeable` | `integer \| null` | No | — | Number of results that can be scraped. |
| `result.data.inputs.links[].split_complete` | `boolean` | No | — | Has splitting of link (if enabled) completed. |
| `result.data.inputs.links[].splits` | `array` | No | — | Invocation IDs given to all sub-links for this link. Progress is tracked by invocation ID. There is only one invocation per link if splitting is disabled or count is below threshold. |
| `result.data.inputs.useAccountless` | `boolean` | No | — | Whether to use Account-Less scraping mode. |
| `result.data.inputs.enrichEmails` | `boolean` | No | — | Whether to enrich emails. Only available for task type "salesnav-profile". |
| `result.data.inputs.splitSearches` | `boolean` | No | — | Whether to split links larger than threshold into smaller sub-links. |
| `result.data.inputs.column_mapping` | `string` | No | — | JSON string for mapping required fields to your CSV column names. |
| `result.data.account` | `string` | No | — | Account type used for this task. |
| `result.data.credit_base` | `number` | No | — | Credits charged per scraped result. Does not include credits charged for enrichment. |
| `result.data.errmsg` | `null \| "TIMED_OUT" \| "NO_ACCOUNT" \| "NO_CREDITS" \| "SYSTEM_ERROR" \| "MAX_RETRIES_EXCEEDED"` | No | — | Allowed: `null`, `TIMED_OUT`, `NO_ACCOUNT`, `NO_CREDITS`, `SYSTEM_ERROR`, `MAX_RETRIES_EXCEEDED`. |
| `result.data.status` | `string` | No | — | Current task status. |
| `result.data.link` | `string \| null` | No | — | Download link for CSV results. Final results are available only when task is in a terminal state - Done, Aborted, or Failed. |
| `result.data.link_size` | `integer \| null` | No | — | Total number of unique results present in CSV. |
| `result.data.dones` | `record` | No | — | Number of results already scraped for each invocation ID. |
| `result.data.ongoing` | `record` | No | — | Number of results being scraped for each invocation ID. |
| `result.data.totals` | `record` | No | — | Number of total results for each invocation ID. |
| `result.data.enrich_final` | `integer \| null` | No | — | Total number of enriched results present in CSV. |
| `result.data.enrich_size` | `record` | No | — | Number of emails found for each invocation ID. |
| `result.data.enrich_msg` | `record` | No | — | Enrichment status for each invocation ID - STARTED, SUCCESS, RESTARTING, SYSTEM\_ERROR, INSUFFICIENT\_CREDITS, TASK\_ABORTED. |
| `result.data.enriched` | `record` | No | — | Number of rows processed for each invocation ID. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "id": {
            "type": "string",
            "description": "Task ID."
          },
          "name": {
            "type": "string",
            "description": "Task name."
          },
          "creator": {
            "type": "string",
            "description": "Username (email) of task creator."
          },
          "created": {
            "type": "string",
            "description": "Timestamp of task creation."
          },
          "type": {
            "type": "string",
            "description": "Type of scraping task.",
            "enum": [
              "salesnav-profile",
              "salesnav-company",
              "find-email",
              "verify-email"
            ]
          },
          "inputs": {
            "type": "object",
            "description": "Input parameters for the task. All parameters are not given for all task types. Task List contains less information than Task Detail.",
            "properties": {
              "accounts": {
                "type": [
                  "array",
                  "null"
                ],
                "description": "List of account IDs to use. Set to null for automatic selection. Only available when useAccountless is false.",
                "items": {
                  "type": "string"
                }
              },
              "links": {
                "type": "array",
                "description": "List of Sales Navigator search URLs to scrape.",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "integer",
                      "description": "Numeric ID assigned to each link, unique to this task."
                    },
                    "link": {
                      "type": "string",
                      "description": "A Sales Navigator search URL."
                    },
                    "end_page": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "default": null
                    },
                    "count": {
                      "type": [
                        "integer",
                        "null"
                      ],
                      "description": "Number of results present on this link."
                    },
                    "count_scrapeable": {
                      "type": [
                        "integer",
                        "null"
                      ],
                      "description": "Number of results that can be scraped."
                    },
                    "split_complete": {
                      "type": "boolean",
                      "description": "Has splitting of link (if enabled) completed."
                    },
                    "splits": {
                      "type": "array",
                      "description": "Invocation IDs given to all sub-links for this link. Progress is tracked by invocation ID. There is only one invocation per link if splitting is disabled or count is below threshold.",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "additionalProperties": false
                }
              },
              "useAccountless": {
                "type": "boolean",
                "description": "Whether to use Account-Less scraping mode."
              },
              "enrichEmails": {
                "type": "boolean",
                "description": "Whether to enrich emails. Only available for task type \"salesnav-profile\"."
              },
              "splitSearches": {
                "type": "boolean",
                "description": "Whether to split links larger than threshold into smaller sub-links."
              },
              "column_mapping": {
                "type": "string",
                "description": "JSON string for mapping required fields to your CSV column names."
              }
            },
            "additionalProperties": false
          },
          "account": {
            "type": "string",
            "description": "Account type used for this task."
          },
          "credit_base": {
            "type": "number",
            "description": "Credits charged per scraped result. Does not include credits charged for enrichment."
          },
          "errmsg": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              null,
              "TIMED_OUT",
              "NO_ACCOUNT",
              "NO_CREDITS",
              "SYSTEM_ERROR",
              "MAX_RETRIES_EXCEEDED"
            ]
          },
          "status": {
            "type": "string",
            "description": "Current task status."
          },
          "link": {
            "type": [
              "string",
              "null"
            ],
            "description": "Download link for CSV results. Final results are available only when task is in a terminal state - Done, Aborted, or Failed."
          },
          "link_size": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Total number of unique results present in CSV."
          },
          "dones": {
            "type": "object",
            "description": "Number of results already scraped for each invocation ID."
          },
          "ongoing": {
            "type": "object",
            "description": "Number of results being scraped for each invocation ID."
          },
          "totals": {
            "type": "object",
            "description": "Number of total results for each invocation ID."
          },
          "enrich_final": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Total number of enriched results present in CSV."
          },
          "enrich_size": {
            "type": "object",
            "description": "Number of emails found for each invocation ID."
          },
          "enrich_msg": {
            "type": "object",
            "description": "Enrichment status for each invocation ID - STARTED, SUCCESS, RESTARTING, SYSTEM_ERROR, INSUFFICIENT_CREDITS, TASK_ABORTED."
          },
          "enriched": {
            "type": "object",
            "description": "Number of rows processed for each invocation ID."
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

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

## Related documentation

* [WizLeads provider guide](https://deepline.com/docs/providers/wizleads/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.