> ## 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.

# Download URLs

> Retrieve download URLs for rendered outputs.



## OpenAPI

````yaml https://www.renderjuice.com/docs/reference/renderjuice-api-sample.json get /jobs/{id}/downloads
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/{id}/downloads:
    get:
      tags:
        - Jobs
      summary: Download URLs
      description: Retrieve download URLs for rendered outputs.
      parameters:
        - schema:
            type: string
            format: uuid
            example: 123e4567-e89b-12d3-a456-426614174000
            description: Unique identifier of the job
          required: true
          description: Unique identifier (UUID) of the job
          name: id
          in: path
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  frames:
                    type: array
                    items:
                      type: string
                      format: uri
                    description: >-
                      Legacy array of rendered frame image download URLs. Prefer
                      frameOutputs when you need original filenames or
                      stereo/multiview metadata.
                  compositeNodes:
                    type: array
                    items:
                      type: string
                      format: uri
                    description: >-
                      Legacy array of composite node output download URLs.
                      Prefer compositeNodeOutputs when you need original
                      filenames or relative paths.
                  frameOutputs:
                    type: array
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                          format: uri
                          description: Direct download URL for this output.
                        fileName:
                          type: string
                          description: Original filename of the output.
                        relativePath:
                          type: string
                          description: >-
                            Relative path to the output file when preserving
                            folders, for example in ZIP downloads or local sync.
                        view:
                          type: string
                          nullable: true
                          description: Stereo or multiview camera suffix when available.
                        outputType:
                          type: string
                          enum:
                            - frame
                            - composite
                          description: Output category.
                        compositeNodeName:
                          type: string
                          description: Compositor output name when available.
                        legacy:
                          type: boolean
                          description: >-
                            True for older outputs that may not include all
                            filename details.
                      required:
                        - url
                        - fileName
                        - view
                        - outputType
                        - legacy
                    description: >-
                      Details for individual frame downloads. Use fileName for
                      the preserved original output filename and view for the
                      stereo or multiview camera suffix.
                  compositeNodeOutputs:
                    type: array
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                          format: uri
                          description: Direct download URL for this output.
                        fileName:
                          type: string
                          description: Original filename of the output.
                        relativePath:
                          type: string
                          description: >-
                            Relative path to the output file when preserving
                            folders, for example in ZIP downloads or local sync.
                        view:
                          type: string
                          nullable: true
                          description: Stereo or multiview camera suffix when available.
                        outputType:
                          type: string
                          enum:
                            - frame
                            - composite
                          description: Output category.
                        compositeNodeName:
                          type: string
                          description: Compositor output name when available.
                        legacy:
                          type: boolean
                          description: >-
                            True for older outputs that may not include all
                            filename details.
                      required:
                        - url
                        - fileName
                        - view
                        - outputType
                        - legacy
                    description: >-
                      Details for individual compositor output downloads. Use
                      fileName for the preserved original leaf filename and
                      relativePath when recreating folders or ZIP entries.
                  transforms:
                    type: object
                    properties:
                      framesZip:
                        anyOf:
                          - type: string
                            format: uri
                          - type: array
                            items:
                              type: string
                              format: uri
                          - nullable: true
                        description: >-
                          URL(s) to download rendered frames as a ZIP archive.
                          Can be a single URL string, array of URLs, empty array
                          if expected but not ready, or null if not available.
                      compositeNodesZip:
                        anyOf:
                          - type: string
                            format: uri
                          - type: array
                            items:
                              type: string
                              format: uri
                          - nullable: true
                        description: >-
                          URL(s) to download composite node outputs as a ZIP
                          archive. Can be a single URL string, array of URLs,
                          empty array if expected but not ready, or null if not
                          available.
                      framesZipOutputs:
                        anyOf:
                          - type: object
                            properties:
                              url:
                                type: string
                                format: uri
                                description: Direct download URL for this output.
                              fileName:
                                type: string
                                description: Original filename of the output.
                              relativePath:
                                type: string
                                description: >-
                                  Relative path to the output file when
                                  preserving folders, for example in ZIP
                                  downloads or local sync.
                              view:
                                type: string
                                nullable: true
                                description: >-
                                  Stereo or multiview camera suffix when
                                  available.
                              outputType:
                                type: string
                                enum:
                                  - frame
                                  - composite
                                description: Output category.
                              compositeNodeName:
                                type: string
                                description: Compositor output name when available.
                              legacy:
                                type: boolean
                                description: >-
                                  True for older outputs that may not include
                                  all filename details.
                            required:
                              - url
                              - fileName
                              - view
                              - outputType
                              - legacy
                          - type: array
                            items:
                              type: object
                              properties:
                                url:
                                  type: string
                                  format: uri
                                  description: Direct download URL for this output.
                                fileName:
                                  type: string
                                  description: Original filename of the output.
                                relativePath:
                                  type: string
                                  description: >-
                                    Relative path to the output file when
                                    preserving folders, for example in ZIP
                                    downloads or local sync.
                                view:
                                  type: string
                                  nullable: true
                                  description: >-
                                    Stereo or multiview camera suffix when
                                    available.
                                outputType:
                                  type: string
                                  enum:
                                    - frame
                                    - composite
                                  description: Output category.
                                compositeNodeName:
                                  type: string
                                  description: Compositor output name when available.
                                legacy:
                                  type: boolean
                                  description: >-
                                    True for older outputs that may not include
                                    all filename details.
                              required:
                                - url
                                - fileName
                                - view
                                - outputType
                                - legacy
                          - nullable: true
                        description: >-
                          Details for frame ZIP downloads, including the URL and
                          original filename when available.
                      compositeNodesZipOutputs:
                        anyOf:
                          - type: object
                            properties:
                              url:
                                type: string
                                format: uri
                                description: Direct download URL for this output.
                              fileName:
                                type: string
                                description: Original filename of the output.
                              relativePath:
                                type: string
                                description: >-
                                  Relative path to the output file when
                                  preserving folders, for example in ZIP
                                  downloads or local sync.
                              view:
                                type: string
                                nullable: true
                                description: >-
                                  Stereo or multiview camera suffix when
                                  available.
                              outputType:
                                type: string
                                enum:
                                  - frame
                                  - composite
                                description: Output category.
                              compositeNodeName:
                                type: string
                                description: Compositor output name when available.
                              legacy:
                                type: boolean
                                description: >-
                                  True for older outputs that may not include
                                  all filename details.
                            required:
                              - url
                              - fileName
                              - view
                              - outputType
                              - legacy
                          - type: array
                            items:
                              type: object
                              properties:
                                url:
                                  type: string
                                  format: uri
                                  description: Direct download URL for this output.
                                fileName:
                                  type: string
                                  description: Original filename of the output.
                                relativePath:
                                  type: string
                                  description: >-
                                    Relative path to the output file when
                                    preserving folders, for example in ZIP
                                    downloads or local sync.
                                view:
                                  type: string
                                  nullable: true
                                  description: >-
                                    Stereo or multiview camera suffix when
                                    available.
                                outputType:
                                  type: string
                                  enum:
                                    - frame
                                    - composite
                                  description: Output category.
                                compositeNodeName:
                                  type: string
                                  description: Compositor output name when available.
                                legacy:
                                  type: boolean
                                  description: >-
                                    True for older outputs that may not include
                                    all filename details.
                              required:
                                - url
                                - fileName
                                - view
                                - outputType
                                - legacy
                          - nullable: true
                        description: >-
                          Details for compositor ZIP downloads, including the
                          URL and original filename when available.
                      video:
                        type: object
                        additionalProperties:
                          type: array
                          items:
                            type: object
                            properties:
                              format:
                                type: string
                                description: Video format identifier (e.g., mp4).
                              label:
                                type: string
                                nullable: true
                                description: >-
                                  Optional label used to distinguish multiple
                                  outputs of the same format.
                              expected:
                                type: boolean
                                description: >-
                                  True when the render config requested this
                                  video encode.
                              available:
                                type: boolean
                                description: >-
                                  True when the video artifact has been
                                  produced.
                              url:
                                type: string
                                nullable: true
                                format: uri
                                description: >-
                                  Signed download URL for the video when
                                  available.
                              fps:
                                type: integer
                                nullable: true
                                minimum: 0
                                exclusiveMinimum: true
                                description: >-
                                  Frames per second used to encode the video
                                  when available.
                              segment:
                                type: object
                                nullable: true
                                properties:
                                  start:
                                    type: integer
                                    minimum: 0
                                    description: >-
                                      First frame number included in this video
                                      output.
                                  end:
                                    type: integer
                                    minimum: 0
                                    description: >-
                                      Last frame number included in this video
                                      output.
                                required:
                                  - start
                                  - end
                                description: >-
                                  Frame range encoded for this video output when
                                  segmented sequences are used.
                            required:
                              - format
                              - label
                              - expected
                              - available
                              - url
                              - fps
                              - segment
                            description: Status for a specific video transform output.
                        description: >-
                          Video transform states keyed by format (e.g., mp4).
                          Each format contains one or more entries.
                    required:
                      - framesZip
                      - compositeNodesZip
                      - video
                    description: Download options for ZIP archives and video outputs.
                required:
                  - frames
                  - compositeNodes
                  - transforms
      security:
        - ApiKeyAuth: []
components:
  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.

````