---
title: "Get app download file"
method: GET
path: "/v1/apps/{documentId}/download/{jobId}"
tags: ["App downloads"]
---

# Get app download file

`GET /v1/apps/{documentId}/download/{jobId}`

## Request

- Base URL: `https://blobsrus.omniapp.co/api`
- URL: `https://blobsrus.omniapp.co/api/v1/apps/{documentId}/download/{jobId}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Stream the finished file for an app download job. Poll [Get app download status](/api/app-downloads/get-app-download-status) until `status` is `complete` first. Finished files are retained for about a day.

## Path parameters

- `documentId` string, required
- `jobId` string, uuid, required

## Query parameters

- `userId` string, uuid

## Response `200`

The file, streamed, with `Content-Type`, `Content-Length`, and `Content-Disposition: attachment` set.

The `Content-Type` indicates the format of the download:

| Format | Content-Type | Extension |
|--------|--------------|-----------|
| `png` | `image/png` | `.png` |
| `pdf` | `application/pdf` | `.pdf` |
| `xlsx` | `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` | `.xlsx` |
| `csv` | `application/zip` (one CSV per query) | `.zip` |

## Other responses

- `202`: The download job is still running. Poll the status endpoint first.
- `400`: `jobId` is not a UUID.
- `401`: Missing or invalid authentication.
- `403`: Apps or scheduled app deliveries aren't enabled for the organization, the user can no longer view or download the app, or a Personal Access Token named another user.
- `404`: App or download job not found.
- `405`: Method Not Allowed - Invalid HTTP method for this endpoint
- `410`: The download job failed.
- `429`: Too Many Requests - Rate limit exceeded (60 requests/minute)
- `500`: The file could not be read from storage.

## Changes

- **2026-11-03** `43290040f88f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/omni/apis/omni-api/changes/v1/apps/:documentId/download/:jobId/get.md)

---

[API](https://skmtc.dev/omni/apis/omni-api.md) - [All operations](https://skmtc.dev/omni/apis/omni-api/llms.txt) - [OpenAPI document](https://skmtc.dev/omni/apis/omni-api/revisions/43290040f88f?raw)