---
title: "List Carrier Files"
method: GET
path: "/carrier/files"
tags: ["carrier", "Files"]
---

# List Carrier Files

`GET /carrier/files`

Returns a list of raw invoice files (CSV, PDF, etc.) from the carrier connection.
Files are filtered by the time Trackstar generated them (defaults to last 24 hours).

## Query parameters

- `start_time` string, date-time
- `end_time` string, date-time
- `limit` integer
- `page_token` string
- `file_type` string
- `file_name` string

## Headers

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

## Response `200`

Successful response

- CarrierFilesResponseSchema
  - `data` CarrierFile[], required — List of carrier files
    - `file_name` string, required — File name.
    - `generated_time` string, date-time, required — Time the file was generated.
    - `file_type` string, required — File extension.
    - `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.
  - `total_count` integer, required — Number of files in current page.
  - `next_token` string, required — Token for next page, null if no more results.

## Other responses

- `422` — Validation error

---

[API](https://skmtc.net/trackstarhq/apis/trackstar-api.md) · [All operations](https://skmtc.net/trackstarhq/apis/trackstar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trackstarhq/trackstar-api/revisions/4bc5c6e1a8bf/schema)