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

# List render jobs

> List all render jobs for the organization. Jobs are retained for 1 hour after completion (DOCX/ODT) or until cleanup (PDF keeps last 5 per document).



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/dev/render
openapi: 3.0.0
info:
  title: Autype Developer API
  description: >-
    Autype Developer API for programmatic document generation.


    ## Authentication

    All endpoints require an API key. Include it in the `X-API-Key` header or as
    a Bearer token.


    ## Rate Limiting

    API requests are rate-limited to 100 requests per minute per API key.


    ## Token Billing

    Rendering operations consume tokens from your organization's balance.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.autype.com
    description: Production
security: []
tags:
  - name: Temporary Images
    description: Upload and manage temporary images for document rendering
  - name: Render
    description: Render documents to PDF, DOCX, or ODT
  - name: Bulk Render
    description: Bulk document generation with variable substitution
  - name: Documents
    description: Document variable inspection
  - name: Projects
    description: List organization projects
paths:
  /api/v1/dev/render:
    get:
      tags:
        - developer-api
      summary: List render jobs
      description: >-
        List all render jobs for the organization. Jobs are retained for 1 hour
        after completion (DOCX/ODT) or until cleanup (PDF keeps last 5 per
        document).
      operationId: RenderController_listRenderJobs_v1
      parameters:
        - name: page
          required: false
          in: query
          description: 'Page number (default: 1)'
          schema:
            type: number
        - name: limit
          required: false
          in: query
          description: 'Items per page (default: 20, max: 100)'
          schema:
            type: number
        - name: status
          required: false
          in: query
          description: Filter by status
          schema:
            type: string
            enum:
              - PENDING
              - PROCESSING
              - COMPLETED
              - FAILED
      responses:
        '200':
          description: List of render jobs
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RenderJobListResponseDto'
        '401':
          description: Invalid or missing API key
      security:
        - api-key: []
components:
  schemas:
    RenderJobListResponseDto:
      type: object
      properties:
        jobs:
          description: List of render jobs
          type: array
          items:
            $ref: '#/components/schemas/RenderJobStatusDto'
        total:
          type: number
          description: Total number of jobs
        page:
          type: number
          description: Current page number
        limit:
          type: number
          description: Items per page
        hasMore:
          type: boolean
          description: Whether more pages are available
      required:
        - jobs
        - total
        - page
        - limit
        - hasMore
    RenderJobStatusDto:
      type: object
      properties:
        jobId:
          type: string
          description: Render job ID
        status:
          type: string
          enum:
            - PENDING
            - PROCESSING
            - COMPLETED
            - FAILED
          description: Current job status
        downloadUrl:
          type: string
          description: >-
            Autype API download URL with signed token (only when completed).
            Alternatively use GET /render/{jobId}/download with API key.
        filename:
          type: string
          description: Filename for download
        format:
          type: string
          enum:
            - PDF
            - DOCX
            - ODT
          description: Output format
        error:
          type: string
          description: Error message if failed
        createdAt:
          format: date-time
          type: string
          description: Job creation timestamp
        completedAt:
          format: date-time
          type: string
          description: Job completion timestamp
        progress:
          type: number
          description: Processing progress (0-100)
      required:
        - jobId
        - status
        - format
        - createdAt
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: X-API-Key
      description: API Key (starts with ak_...)

````