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

# List your team's async jobs

> Lists your team's jobs under `jobs` — use it to recover a `job_id` you no longer hold, then poll it on its task's status endpoint or cancel it. Defaults to pending and running; pass `status` (repeatable) for terminal ones, which stay listed only for the orchestrator's retention window. Page with `page_size` and `next_page_token`, continuing until that token is null rather than until a short page: a page can be short, or empty, and still have more behind it. A `page_token` is valid only for the `status` filter it was returned with. Rows are newest first, within a page and across them, so the job you just submitted is at the front of page one.



## OpenAPI

````yaml /openapi.json get /v2/async/jobs
openapi: 3.1.0
info:
  title: Nixtla Forecast API
  description: >-
    API for TimeGPT forecast. Just send your data as json and get results. We do
    the heavy lifting.
  version: 0.4.3
servers:
  - url: https://api.nixtla.io
security: []
paths:
  /v2/async/jobs:
    get:
      tags:
        - async jobs
      summary: List your team's async jobs
      description: >-
        Lists your team's jobs under `jobs` — use it to recover a `job_id` you
        no longer hold, then poll it on its task's status endpoint or cancel it.
        Defaults to pending and running; pass `status` (repeatable) for terminal
        ones, which stay listed only for the orchestrator's retention window.
        Page with `page_size` and `next_page_token`, continuing until that token
        is null rather than until a short page: a page can be short, or empty,
        and still have more behind it. A `page_token` is valid only for the
        `status` filter it was returned with. Rows are newest first, within a
        page and across them, so the job you just submitted is at the front of
        page one.
      operationId: list_async_jobs_v2_async_jobs_get
      parameters:
        - name: status
          in: query
          required: false
          schema:
            anyOf:
              - type: array
                items:
                  $ref: '#/components/schemas/AsyncJobStatus'
              - type: 'null'
            description: Job statuses to list. Repeatable. Defaults to pending and running.
            title: Status
          description: Job statuses to list. Repeatable. Defaults to pending and running.
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            maximum: 200
            minimum: 1
            description: Maximum rows per page.
            default: 200
            title: Page Size
          description: Maximum rows per page.
        - name: page_token
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 4096
              - type: 'null'
            description: '`next_page_token` from the previous page.'
            title: Page Token
          description: '`next_page_token` from the previous page.'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AsyncJobsResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    AsyncJobStatus:
      type: string
      enum:
        - pending
        - running
        - succeeded
        - failed
        - cancelled
      title: AsyncJobStatus
    AsyncJobsResponse:
      properties:
        jobs:
          items:
            $ref: '#/components/schemas/AsyncJobSummary'
          type: array
          title: Jobs
          description: One page of the team's jobs, newest first.
        next_page_token:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Page Token
          description: >-
            Cursor for the next page, or null on the last one. Page until this
            is null, not until a short page — a page can be short, or empty, and
            still have more behind it. Valid only for the `status` filter it was
            returned with.
      type: object
      required:
        - jobs
      title: AsyncJobsResponse
      description: >-
        The body of `GET /v2/async/jobs`.


        An object rather than a bare array, matching the rest of the `v2`
        family, so a new field is not

        a shape change.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    AsyncJobSummary:
      properties:
        job_id:
          type: string
          title: Job Id
          description: >-
            Identifier for the job, usable on its task's status endpoint and on
            cancel.
          examples:
            - fc-4f2a1c9e8b7d4a6f9c3e1b5d7a9f2c4e
        task_name:
          anyOf:
            - $ref: '#/components/schemas/AsyncJobTaskName'
            - type: 'null'
          description: >-
            Which async task this job runs; null only if the `job_id` carries no
            recognised prefix.
        status:
          $ref: '#/components/schemas/AsyncJobStatus'
          description: Lifecycle state; terminal states are succeeded, failed, cancelled.
        created_at:
          type: string
          title: Created At
          description: ISO-8601 timestamp of when the job was accepted.
      type: object
      required:
        - job_id
        - task_name
        - status
        - created_at
      title: AsyncJobSummary
      description: >-
        One job, as the listing endpoint names it.


        A terminal job stays listed only for the orchestrator's retention
        window, so a row's absence is

        not evidence it never existed. Carries no result — poll the task's
        status endpoint for that.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    AsyncJobTaskName:
      type: string
      enum:
        - finetune
        - forecast
        - cross_validation
        - anomaly_detection
        - simulate
        - explain
        - execute_step
      title: AsyncJobTaskName
  securitySchemes:
    HTTPBearer:
      type: http
      description: HTTPBearer
      scheme: bearer

````