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

> ## Agent Instructions
> Trackstar is a unified REST API for WMS, cart, and carrier systems. Base URL: https://production.trackstarhq.com. There is no SDK; call the API with plain HTTP.
> Send x-trackstar-api-key on every request. Endpoints scoped to one connection also need x-trackstar-access-token. Read both from environment variables and never print them.
> Reads return data Trackstar has already synced from the connected system. Writes (POST, PUT, PATCH, DELETE) are forwarded to the connected system immediately.
> A new connection has no data until its initial sync finishes. Wait for the connection.historical-sync-completed webhook, or poll GET /connections/{connection_id} and check historical_sync_completed.
> List endpoints page with page_token and next_token (limit is capped at 1000). Repeat every filter on every page. Filters use field[operator]=value, for example created_date[gte]=2026-01-01T00:00:00Z.
> Write bodies must not contain null or empty strings; omit the field instead. Call GET /integrations/{integration_type}/{integration_name}/write-info first to learn the exact fields an integration accepts.
> To test without real credentials, POST /sandbox/generate-sandbox/{wms|cart|carrier} with the API key returns a sandbox access token. Start at https://docs.trackstarhq.com/how-to-guides/build-with-ai.md and install the skills with: npx skills add https://docs.trackstarhq.com

# Files

> Raw carrier invoice files with presigned download links

Files are raw documents generated by carrier integrations, such as invoice CSVs or PDFs. The files endpoint returns presigned download URLs that expire after 20 minutes.

For reference shapes per carrier — including inline sample rows and downloadable synthetic CSVs for each integration and regional variant — see [Carrier Sample Files](/api-reference/carrier-api/sample-files/overview).

### Fields

| Field | Description |
| :- | :- |
| `id` | The file's unique ID, used to fetch it from `/carrier/files/{id}` |
| `file_name` | Name of the file |
| `created_date` | ISO 8601 timestamp when the file was generated |
| `file_type` | File extension (e.g., "csv", "pdf") |
| `download_url` | Presigned download URL (expires after 20 minutes) |
| `download_url_expires_at` | ISO 8601 timestamp when the download URL expires |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.