TRtrackstarhq
carrier
Files

Get Carrier File

Changed on

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.

get/carrier/files/{file_id}

Request

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

Path parameters

file_idstring required

Headers

x-trackstar-api-keystring required
Example:<x-trackstar-api-key>

Your organization-level Trackstar API key.

x-trackstar-access-tokenstring required
Example:<x-trackstar-access-token>

Your user's access token for a specific integration (ShipHero, Extensiv, etc).

Response

Successful response

Example response

{
  "data": {
    "id": "2025-11-15T00:00:00/crawl_id/invoice.csv",
    "created_date": "2022-01-01T00:00:00Z",
    "updated_date": "2022-01-02T05:05:05Z",
    "file_name": "invoice.csv",
    "file_type": "csv",
    "trackstar_created_date": "2023-03-15T13:45:30Z",
    "trackstar_updated_date": "2023-03-15T13:45:30Z",
    "download_url": "https://s3.amazonaws.com/...",
    "download_url_expires_at": "2025-01-15T10:50:00Z"
  }
}

Changes