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

# List jobs

> List jobs with pagination and optional status filter.



## OpenAPI

````yaml https://www.renderjuice.com/docs/reference/renderjuice-api-sample.json get /jobs
openapi: 3.0.0
info:
  title: Renderjuice External API
  version: 0.0.1
  description: External API surface generated from the /api/external/v1 manifest.
servers:
  - url: https://api.renderjuice.com/api/external/v1
security:
  - ApiKeyAuth: []
paths:
  /jobs:
    get:
      tags:
        - Jobs
      summary: List jobs
      description: List jobs with pagination and optional status filter.
      parameters:
        - schema:
            type: integer
            minimum: 0
            exclusiveMinimum: true
            default: 1
            example: 1
            description: >-
              Page number to retrieve (1-indexed). Defaults to 1 if not
              provided.
          required: false
          description: Page number to retrieve (1-indexed)
          name: page
          in: query
        - schema:
            type: integer
            minimum: 0
            exclusiveMinimum: true
            maximum: 100
            default: 20
            example: 20
            description: >-
              Number of jobs to return per page. Defaults to 20 if not provided
              (max: 100).
          required: false
          description: Number of jobs to return per page
          name: pageSize
          in: query
        - schema:
            type: string
            enum:
              - created
              - validating
              - validated
              - debugging
              - rendering
              - finalizing
              - completed
              - failed
              - canceled
              - booting
              - suspended
            example: rendering
            description: >-
              Filter jobs by status. If not provided, returns jobs with all
              statuses.
          required: false
          description: Filter jobs by status
          name: status
          in: query
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  jobs:
                    type: array
                    items:
                      $ref: '#/components/schemas/Job'
                  pagination:
                    type: object
                    properties:
                      page:
                        type: number
                        example: 1
                        description: Current page number (1-indexed)
                      pageSize:
                        type: number
                        example: 10
                        description: Number of items per page
                      total:
                        type: number
                        example: 100
                        description: Total number of items across all pages
                      totalPages:
                        type: number
                        example: 10
                        description: Total number of pages
                    required:
                      - page
                      - pageSize
                      - total
                      - totalPages
                required:
                  - jobs
                  - pagination
      security:
        - ApiKeyAuth: []
components:
  schemas:
    Job:
      type: object
      properties:
        id:
          type: string
          format: uuid
          example: 123e4567-e89b-12d3-a456-426614174000
          description: Unique identifier of the job
        status:
          type: string
          enum:
            - created
            - validating
            - validated
            - debugging
            - rendering
            - finalizing
            - completed
            - failed
            - canceled
            - booting
            - suspended
          example: completed
          description: Current status of the job
        userId:
          type: string
          format: uuid
          description: ID of the user who created the job
        workspaceId:
          type: string
          format: uuid
          description: ID of the workspace this job belongs to
        rootFolderId:
          type: string
          nullable: true
          format: uuid
          description: ID of the root folder containing the job files
        createdAt:
          type: string
          format: date-time
          description: ISO 8601 timestamp when the job was created
        updatedAt:
          type: string
          format: date-time
          description: ISO 8601 timestamp when the job was last updated
        normalizedSeconds:
          type: number
          description: Normalized rendering time in seconds (adjusted for GPU performance)
        previewUrl:
          type: string
          nullable: true
          format: uri
          description: URL to a preview image of the rendered output, if available
        failedReason:
          type: object
          nullable: true
          properties:
            name:
              type: string
              description: Name of the error that caused the failure
            type:
              type: string
              description: Type or category of the error
          required:
            - name
            - type
          description: Details about why the job failed, if applicable
        requestedConfig:
          nullable: true
          description: Override configuration that was requested for this job
        finalConfig:
          nullable: true
          description: >-
            Final configuration that was used for rendering (may differ from
            requested)
        output:
          type: object
          properties:
            isDeletedForClient:
              type: boolean
              description: >-
                Whether the output files have been deleted from
                client-accessible storage
          required:
            - isDeletedForClient
          description: Information about the job output files
        isAnalysisSkipped:
          type: boolean
          description: Whether scene file analysis was skipped for this job
        analysisId:
          type: string
          nullable: true
          format: uuid
          description: ID of the analysis associated with this job
        analysis:
          nullable: true
          description: Analysis results for the scene file
        sceneFile:
          nullable: true
          description: Information about the scene file used for rendering
      required:
        - id
        - status
        - workspaceId
        - createdAt
        - updatedAt
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: RJ-XXX...
      description: >-
        API key authentication. Format: `Bearer RJ-XXX...`. Get your API key
        from the Renderjuice dashboard.

````