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

# List Jobs



## OpenAPI

````yaml api-reference/gpus-v2-spec/list-jobs.json GET /gpus/v2/jobs
openapi: 3.0.0
info:
  title: Novita GPU API v2
  version: 2.0.0
servers:
  - url: https://api.novita.ai
security: []
paths:
  /gpus/v2/jobs:
    get:
      summary: List Jobs
      parameters:
        - name: Authorization
          in: header
          required: true
          schema:
            type: string
          description: 'Bearer authentication format, e.g.: `Bearer {{API_KEY}}`.'
        - name: limit
          in: query
          required: false
          schema:
            type: integer
          description: Maximum number of items to return. Integer, value >= 0.
        - name: cursor
          in: query
          required: false
          schema:
            type: string
          description: >-
            Cursor returned by the previous page. Leave empty for the first
            request. String, length: 0-1024 characters.
        - name: job_id
          in: query
          required: false
          schema:
            type: string
          description: Filter by job ID.
        - name: type
          in: query
          required: false
          schema:
            type: string
          description: >-
            Filter by job type, e.g.: `saveImage`, `instanceMigrate`,
            `autoInstanceMigrate`.
        - name: status
          in: query
          required: false
          schema:
            type: string
          description: Filter by job status.
        - name: start_time
          in: query
          required: false
          schema:
            type: integer
          description: Lower bound of the creation time range. Unix timestamp.
        - name: end_time
          in: query
          required: false
          schema:
            type: integer
          description: Upper bound of the creation time range. Unix timestamp.
        - name: member_ids
          in: query
          required: false
          schema:
            type: string
          description: >-
            Filter by creator member ID. Multiple IDs are comma-separated. Maps
            to `member_id` in the response.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: Job list
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Job ID
                          example: job-id
                        type:
                          type: string
                          description: Job type
                          example: saveImage
                        envs:
                          type: array
                          items:
                            type: string
                          description: Job environment variables
                          example: []
                        status:
                          type: object
                          description: Job status
                          properties:
                            status:
                              type: string
                              description: Status value
                              example: Running
                            error:
                              type: string
                              description: Error code or error type
                              example: ''
                            message:
                              type: string
                              description: Error message
                              example: ''
                        log:
                          type: string
                          description: Job log endpoint
                        created_at:
                          type: integer
                          description: Creation time. Unix timestamp
                          example: 1714982400
                        member_id:
                          type: string
                          description: >-
                            Creator member ID. Same semantics as the legacy
                            `creator` field
                          example: member-id
                        owner_id:
                          type: string
                          description: >-
                            Owner user UUID. Same semantics as the legacy `uuid`
                            field
                          example: owner-id
                        deleted_time:
                          type: integer
                          description: Deletion time. Unix timestamp
                          example: 0
                        update_at:
                          type: integer
                          description: Update time. Same semantics as v1, Unix timestamp
                          example: 1714982600
                        instance_id:
                          type: string
                          description: Associated instance ID
                          example: instance-id
                  next_cursor:
                    type: string
                    description: Cursor for the next page. Empty when no more data
                    example: eyJpZCI6Im5leHQtcGFnZSJ9
                  has_more:
                    type: boolean
                    description: Whether more data is available
                    example: true

````