---
title: "Download Player Bboxes"
method: GET
path: "/api/v1/jobs/{job_id}/player-bboxes/download"
tags: ["Jobs"]
---

# Download Player Bboxes

`GET /api/v1/jobs/{job_id}/player-bboxes/download`

## Request

- Base URL: `https://developer.preciser.io`
- URL: `https://developer.preciser.io/api/v1/jobs/{job_id}/player-bboxes/download`
- Auth: none declared. Required headers: `x-api-key`, `League`

Download all frames as player-bboxes.jsonl.gz; follow the 303 redirect.

Requires raw video status '4', plus the same x-api-key and League as the
submitting client. Other video states cannot obtain a download URL. The signed
URL is short-lived; request this endpoint again for a fresh URL. Keep the URL
private. File checksum and byte size are provided by the metadata endpoint.

## Path parameters

- `job_id` string, required

## Headers

- `x-api-key` string, required: Required API key issued by Preciser.
- `League` string, required: Required tenant/database selector, for example pitchbio-master.

## Other responses

- `303`: Redirect to a private GCS download URL valid for 15 minutes.
- `409`: Video status is not 4 or bbox export is not ready.
- `422`: Validation Error

## Changes

- **2026-10-02** `4476d4a8068c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/preciser/apis/preciser-data-management-api/changes/api/v1/jobs/:job_id/player-bboxes/download/get.md)

---

[API](https://skmtc.dev/preciser/apis/preciser-data-management-api.md) - [All operations](https://skmtc.dev/preciser/apis/preciser-data-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/preciser/apis/preciser-data-management-api/revisions/8c8958673e34?raw)