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

# Download one snapshot or part

> Returns the archive bytes (200) or a 307 redirect when the storage backend issues signed URLs (S3 signed mode, Bunny Pull Zone).



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/jobs/{name}/backups/{filename}/download
openapi: 3.1.0
info:
  description: >-
    snapr is a self-hosted backup service. This document describes its JSON HTTP
    API.
  title: snapr API
  version: dev
servers: []
security: []
paths:
  /api/v1/jobs/{name}/backups/{filename}/download:
    get:
      tags:
        - Backups
      summary: Download one snapshot or part
      description: >-
        Returns the archive bytes (200) or a 307 redirect when the storage
        backend issues signed URLs (S3 signed mode, Bunny Pull Zone).
      operationId: downloadBackup
      parameters:
        - in: path
          name: name
          required: true
          schema:
            type: string
        - description: Snapshot ID or part filename. Must not contain '/', '\', or '..'.
          in: path
          name: filename
          required: true
          schema:
            description: Snapshot ID or part filename. Must not contain '/', '\', or '..'.
            type: string
      responses:
        '200':
          content:
            application/octet-stream:
              schema:
                contentMediaType: application/octet-stream
                format: binary
                type: string
          description: Archive stream
        '307':
          description: Redirect to a signed storage URL
        '400':
          description: Filename contains '/', '\', or '..'
        '403':
          description: server.permissions.allowBackupDownload is false
        '404':
          description: Job or snapshot not found
        '501':
          description: Storage backend has no download support
      security:
        - session: []
components:
  securitySchemes:
    session:
      description: Session JWT issued by POST /auth/login. Public endpoints ignore it.
      in: cookie
      name: snapr_session
      type: apiKey

````