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

# Task Result

> Retrieve the results of a completed task.



## OpenAPI

````yaml /api-reference/openapi.json get /v2/tasks/{task_id}/results
openapi: 3.1.0
info:
  title: Nimble SDK
  version: 1.0.0
  description: The AI-Native SDK for Real-Time Web Data at scale
servers:
  - url: https://sdk.nimbleway.com
security: []
paths:
  /v2/tasks/{task_id}/results:
    get:
      tags:
        - Tasks
      summary: Task Result
      description: Retrieve the results of a completed task.
      parameters:
        - description: The unique identifier of the task.
          in: path
          name: task_id
          required: true
          schema:
            description: The unique identifier of the task.
            examples:
              - 123e4567-e89b-12d3-a456-426614174000
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: {}
                description: The results of the completed task.
                propertyNames:
                  type: string
                type: object
          description: Task results
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskPendingResponse'
          description: Task is still pending and results are not yet available.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskErrorResponse'
          description: Task not found or results are no longer available.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskFailedResponse'
          description: Task failed or error retrieving results.
      security:
        - BearerAuth: []
components:
  schemas:
    TaskPendingResponse:
      additionalProperties: false
      description: Response when task is still pending.
      properties:
        error:
          const: task not finished yet
          description: Error message indicating task is not finished yet.
          type: string
        status:
          const: failed
          description: Status indicating the task is still pending.
          type: string
      required:
        - status
        - error
      type: object
    TaskErrorResponse:
      additionalProperties: false
      description: Error response for task operations.
      properties:
        error:
          description: Error message describing what went wrong.
          examples:
            - task not found
          type: string
        status:
          const: failed
          description: Status indicating the request failed.
          type: string
      required:
        - status
        - error
      type: object
    TaskFailedResponse:
      additionalProperties: false
      description: Response when task execution failed.
      properties:
        error:
          description: Error message.
          examples:
            - task failed
          type: string
        status:
          const: failed
          description: Status indicating the task failed.
          type: string
        task:
          additionalProperties: false
          description: The failed task details.
          properties:
            _query: {}
            account_name:
              description: Account name that owns the task.
              type: string
            api_type:
              enum:
                - web
                - serp
                - ecommerce
                - social
                - media
                - agent
                - extract
                - fast-serp
                - labs
              type: string
            batch_id:
              anyOf:
                - type: string
                - type: 'null'
              description: Batch ID if this task is part of a batch.
              examples:
                - 4b0a90bf-c951-42e4-95b3-a95a65ba69fc
            created_at:
              description: Timestamp when the task was created.
              examples:
                - '2024-01-15T10:30:00Z'
              type: string
            download_url:
              anyOf:
                - format: uri
                  type: string
                - type: 'null'
              description: URL for downloading the task results.
              examples:
                - >-
                  https://api.webit.live/api/v2/tasks/123e4567-e89b-12d3-a456-426614174000/results
            error:
              anyOf:
                - type: string
                - type: 'null'
              description: Error message if the task failed.
              examples:
                - Connection timeout
            error_type:
              anyOf:
                - type: string
                - type: 'null'
              description: Classification of the error type.
              examples:
                - timeout_error
            id:
              description: Unique task identifier.
              examples:
                - 123e4567-e89b-12d3-a456-426614174000
              minLength: 1
              type: string
            input:
              description: Original input data for the task.
            modified_at:
              description: Timestamp when the task was last modified.
              examples:
                - '2024-01-15T10:35:00Z'
              type: string
            output_url:
              anyOf:
                - type: string
                - type: 'null'
              description: Storage location of the output data.
            queue:
              description: Queue name the task was submitted to.
              type: string
            state:
              description: Current state of the task.
              enum:
                - pending
                - queued
                - in_progress
                - success
                - error
              examples:
                - pending
              type: string
            status_code:
              description: HTTP status code from the task execution.
              examples:
                - 200
              type: number
            status_url:
              description: URL for checking the task status.
              examples:
                - >-
                  https://api.webit.live/api/v2/tasks/123e4567-e89b-12d3-a456-426614174000
              format: uri
              type: string
          required:
            - id
            - state
            - status_url
            - created_at
            - input
            - _query
          type: object
      required:
        - status
        - error
        - task
      type: object
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````

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