---
title: "Get batch status (includes signed download URL when eligible)"
method: GET
path: "/batch/{batchId}"
tags: ["Batch"]
---

# Get batch status (includes signed download URL when eligible)

`GET /batch/{batchId}`

## Request

- Base URL: `https://api3.mountain.com`
- URL: `https://api3.mountain.com/batch/{batchId}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/mountain/apis/mntn-ai-ops-reporting-api/docs/batch/:batchId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the batch status. When the batch is SUCCEEDED and within retention, a freshly-signed download URL is included in the response. The URL is generated on every call — clients should not treat it as stable.

## Path parameters

- `batchId` integer, required

## Query parameters

- `key` string, required

## Response `200`

Batch status

- ExportStatusResponse
  - `batchId` integer
  - `status` string
  - `submittedAt` string
  - `reportName` string
  - `requestParams` string
  - `startedAt` string
  - `completedAt` string
  - `downloadUrl` string
  - `downloadExpiresAt` string
  - `error` ExportErrorDetail
    - `code` string
    - `message` string
    - `retryable` boolean

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Batch not found
- `413`: Payload Too Large — the query exceeds server memory limits. Use the asynchronous /batch endpoint for large requests.
- `500`: Internal Server Error
- `503`: Signing subsystem temporarily unavailable
- `504`: Gateway Timeout — the query exceeded the synchronous request time limit.

---

[API](https://skmtc.dev/mountain/apis/mntn-ai-ops-reporting-api.md) - [All operations](https://skmtc.dev/mountain/apis/mntn-ai-ops-reporting-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mountain/apis/mntn-ai-ops-reporting-api/revisions/826e4445c45e?raw)