---
title: "Get Carrier File"
method: GET
path: "/carrier/files/{file_id}"
tags: ["carrier", "Files"]
---

# Get Carrier File

`GET /carrier/files/{file_id}`

## Request

- Base URL: `https://production.trackstarhq.com`
- URL: `https://production.trackstarhq.com/carrier/files/{file_id}`
- Auth: none required

Returns a single raw file for the Carrier connection with the associated id, with a
freshly minted download URL. This is what the carrier-file.created webhook points
at: the webhook carries the file's id, and the URL is minted here because a
presigned URL expires faster than a webhook can be retried.

## Path parameters

- `file_id` string, required

## Headers

- `x-trackstar-api-key` string, required
- `x-trackstar-access-token` string, required

## Response `200`

Successful response

- CarrierFilesSingleItemEndpoint
  - `data` CarrierFileWithUrlSchema
    - `id` string, required: The unique ID of the file.
    - `created_date` string, date-time, required: The date the file was created.
    - `updated_date` string, date-time, required: The date the file was last updated.
    - `file_name` string, required: The file name.
    - `file_type` string, nullable, required: The file extension.
    - `trackstar_created_date` string, date-time, required
    - `trackstar_updated_date` string, date-time, required
    - `download_url` string, required: Presigned download URL (valid for 20 minutes).
    - `download_url_expires_at` string, date-time, required: Expiration timestamp for the download URL.

## Other responses

- `404`: Not found
- `422`: Validation error

## Changes

- **2026-11-03** `f9f948f2a7b3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trackstarhq/apis/trackstar-api/changes/carrier/files/:file_id/get.md)

---

[API](https://skmtc.dev/trackstarhq/apis/trackstar-api.md) - [All operations](https://skmtc.dev/trackstarhq/apis/trackstar-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trackstarhq/apis/trackstar-api/revisions/08647f790594?raw)