> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trackstarhq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Carrier File

> 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.



## OpenAPI

````yaml get /carrier/files/{file_id}
openapi: 3.1.0
info:
  description: >

    Trackstar is a Unified API that provides standard endpoints for Supply Chain
    Logistics. We currently offer an API for Warehouse Management Systems (WMS).
  title: Trackstar API
  version: 0.1.0
servers:
  - description: Trackstar API
    url: https://production.trackstarhq.com
security: []
tags: []
externalDocs:
  description: Trackstar API Documentation
  url: https://docs.trackstarhq.com
paths:
  /carrier/files/{file_id}:
    get:
      tags:
        - carrier
        - Files
      summary: Get Carrier File
      description: >-
        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.
      operationId: get_carrier_get_file
      parameters:
        - in: path
          name: file_id
          schema:
            type: string
          required: true
        - in: header
          name: x-trackstar-api-key
          description: Your organization-level Trackstar API key.
          schema:
            type: string
            example: <x-trackstar-api-key>
          required: true
        - in: header
          name: x-trackstar-access-token
          description: >-
            Your user's access token for a specific integration (ShipHero,
            Extensiv, etc).
          schema:
            type: string
            example: <x-trackstar-access-token>
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CarrierFilesSingleItemEndpoint'
          description: Successful response
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPError'
          description: Not found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
          description: Validation error
components:
  schemas:
    CarrierFilesSingleItemEndpoint:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/CarrierFileWithUrlSchema'
      additionalProperties: false
      title: CarrierFilesSingleItemEndpoint
    HTTPError:
      properties:
        error:
          type: string
        id:
          type: string
          description: The ID of the item that wasn't found.
      required:
        - error
      type: object
      title: HTTPError
    ValidationError:
      properties:
        error:
          type: string
        detail:
          type: object
          properties:
            <location>:
              type: object
              properties:
                <field_name>:
                  type: array
                  items:
                    type: string
      required:
        - error
      type: object
      title: ValidationError
    CarrierFileWithUrlSchema:
      type: object
      properties:
        id:
          type: string
          description: The unique ID of the file.
          example: 2025-11-15T00:00:00/crawl_id/invoice.csv
        created_date:
          type: string
          format: date-time
          description: The date the file was created.
          example: '2022-01-01T00:00:00Z'
        updated_date:
          type: string
          format: date-time
          description: The date the file was last updated.
          example: '2022-01-02T05:05:05Z'
        file_name:
          type: string
          description: The file name.
          example: invoice.csv
        file_type:
          type:
            - string
            - 'null'
          description: The file extension.
          example: csv
        trackstar_created_date:
          type: string
          format: date-time
          description: ''
        trackstar_updated_date:
          type: string
          format: date-time
          description: ''
        download_url:
          type: string
          description: Presigned download URL (valid for 20 minutes).
          example: https://s3.amazonaws.com/...
        download_url_expires_at:
          type: string
          format: date-time
          description: Expiration timestamp for the download URL.
          example: '2025-01-15T10:50:00Z'
      required:
        - created_date
        - download_url
        - download_url_expires_at
        - file_name
        - file_type
        - id
        - trackstar_created_date
        - trackstar_updated_date
        - updated_date
      additionalProperties: false
      title: CarrierFileWithUrlSchema

````