v1

latestOpenAPI 3.1.02026-07-22802,2441.7 MB

carrier

Files

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

get/carrier/files

Query parameters

start_timestring date-time

Filter by the time Trackstar generated the file in ISO Format. Defaults to 24 hours ago.

end_timestring date-time

Filter by the time Trackstar generated the file in ISO Format. Defaults to current time.

limitinteger

Maximum number of files to return (max 1000).

page_tokenstring

Token for paginating results.

file_typestring

Example:csv

Filter by file type (e.g., csv, pdf).

file_namestring

Example:0081234

Filter files by name (case-insensitive match).

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

total_countinteger required

Number of files in current page.

next_tokenstring required

Token for next page, null if no more results.

Example response

{
  "data": [
    {
      "file_name": "invoice.csv",
      "file_type": "csv",
      "download_url": "https://s3.amazonaws.com/...",
      "download_url_expires_at": "2025-01-15T10:50:00Z"
    }
  ],
  "total_count": 45,
  "next_token": "base64_token"
}