Returns raw invoice files (CSV, PDF, etc.) from the carrier connection, each with
a presigned download URL. Filter with created_date to select a time range.
Subscribe to the carrier-file.created webhook to be notified when a new file is
available, then fetch that file from /carrier/files/ for a fresh URL instead
of polling.
Use this parameter to retrieve items filtered to a specific date range. For example, to get all items between 2023-03-10 and 2023-03-22, you would send created_date[gte]=2023-03-10T00:00:00Z&created_date[lte]=2023-03-22T00:00:00Z. See the filtering docs for more. The date format must always be YYYY-MM-DDTHH:MM:SSZ.
Note: it is much more efficient to use a combination of gte/lte than it is to use gt/lt.
Filter by file name (matches names containing the value).
This filter is not indexed. Pair it with an indexed filter (updated_date, created_date, trackstar_updated_date, trackstar_created_date) using eq, gt, gte, lt or lte for faster, fuller pages. See filtering docs.
Filter by the file extension.
This filter is not indexed. Pair it with an indexed filter (updated_date, created_date, trackstar_updated_date, trackstar_created_date) using eq, gt, gte, lt or lte for faster, fuller pages. See filtering docs.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Trackstar","colors":{"primary":"#7691DA","light":"#D3D665","dark":"#2E3B72"},"logo":{"light":"https://mintcdn.com/trackstar/e_R8AMY4ayyVfYRU/logo/light.svg?fit=max\u0026auto=format\u0026n=e_R8AMY4ayyVfYRU\u0026q=85\u0026s=eb832f4ffc768291fd95c4939b2ac6c2","dark":"https://mintcdn.com/trackstar/e_R8AMY4ayyVfYRU/logo/dark.svg?fit=max\u0026auto=format\u0026n=e_R8AMY4ayyVfYRU\u0026q=85\u0026s=1a2845225060cfe1d75c91a7240341a0"},"favicon":"https://mintcdn.com/trackstar/ronaGfFeKtERpohJ/favicon.png?fit=max\u0026auto=format\u0026n=ronaGfFeKtERpohJ\u0026q=85\u0026s=b3a24a0d7d7c7acc8e7394c0640eb8c6","api":{"openapi":"https://production.trackstarhq.com/openapi.json","mdx":{"server":"https://production.trackstarhq.com"}},"navbar":{"primary":{"type":"button","label":"Get an API Key","href":"https://www.trackstarhq.com/#"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/trackstarhq","website":"https://www.trackstarhq.com/"}},"integrations":{"clearbit":{"publicApiKey":"pk_1c5d72a7b03149b504c277cee5b4032a"}},"contextual":{"options":["copy","view","claude","chatgpt","cursor","vscode","mcp","add-mcp","download-spec"],"display":"header"},"markdown":{"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"]},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Request an API Key","icon":"key","href":"https://trackstarhq.com/get-started"},{"anchor":"Login to Dashboard","icon":"browser","href":"https://dashboard.trackstarhq.com"},{"anchor":"WMS Integrations","icon":"warehouse","href":"https://trackstarhq.com/integrations/wms"},{"anchor":"Cart Integrations","icon":"cart-shopping","href":"https://trackstarhq.com/integrations/cart"},{"anchor":"Carrier Integrations","icon":"truck","href":"https://trackstarhq.com/integrations/carrier"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"trackstar","hasAudioNarration":false,"actualSubdomain":"trackstar","customDomains":["docs.trackstarhq.com"],"gitSource":{"type":"github","owner":"trackstarhq","repo":"documentation","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae8f43c1759a4785ee27d5d","collectionId":"23316609-e58a-466e-8cac-6dc49b13e166","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae8f43c1759a4785ee27d5d"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae8f55a63ab8a96908cecc8","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"Guides","count":67},{"language":"default","tag":"How-To Guides","count":58},{"language":"default","tag":"WMS API","count":55},{"language":"default","tag":"WMS API Reference","count":55},{"language":"default","tag":"Webhooks","count":48},{"language":"default","tag":"WMS","count":29},{"language":"default","tag":"Admin API","count":21},{"language":"default","tag":"Admin API Reference","count":20},{"language":"default","tag":"Orders","count":17},{"language":"default","tag":"Cart API","count":16}]},"assistantConfig":{"enableStarterQuestions":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/carrier-api/files/get","slug":"/api-reference/carrier-api/files/get","pageMetadata":{"openapi":"get /carrier/files","title":"List Carrier Files","description":"Returns raw invoice files (CSV, PDF, etc.) from the carrier connection, each with\na presigned download URL. Filter with created_date to select a time range.\nSubscribe to the carrier-file.created webhook to be notified when a new file is\navailable, then fetch that file from /carrier/files/{id} for a fresh URL instead\nof polling.","href":"/api-reference/carrier-api/files/get"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Returns raw invoice files (CSV, PDF, etc.) from the carrier connection, each with\\na presigned download URL. Filter with created_date to select a time range.\\nSubscribe to the carrier-file.created webhook to be notified when a new file is\\navailable, then fetch that file from /carrier/files/\", \" for a fresh URL instead\\nof polling.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"get /carrier/files","title":"List Carrier Files","description":"Returns raw invoice files (CSV, PDF, etc.) from the carrier connection, each with\na presigned download URL. Filter with created_date to select a time range.\nSubscribe to the carrier-file.created webhook to be notified when a new file is\navailable, then fetch that file from /carrier/files/{id} for a fresh URL instead\nof polling.","href":"/api-reference/carrier-api/files/get"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/trackstar/30b448b1cb413b03/required.js","/_mintlify/custom/trackstar/a23a6fd668fcabff/tab-dropdown.js","/_mintlify/custom/trackstar/bf284930523528a1/write-fields.js"],"openApiReferenceData":{"operation":{"parameters":["c2ebfcbb-6c0d-4f15-a636-deab4867af44","60751e0e-a545-45b3-979a-233f9ff351ab","abc090f2-623e-407a-bae2-cccebeb922c3","ea139862-683d-472a-b2f0-70b6e6dbfabf","7c9a4fae-a029-4254-bb78-8a4f75268ff4","88aab8f4-1444-43af-8d26-426b93e71ca1","3201ab48-9cef-4067-983c-cb201507d746","72f31e16-7d2d-4d5b-9383-b2f741dcc92f","de6aa1f7-70e3-4b4e-a066-d4a96f0ae4d1","39869061-37e7-4cb1-b87d-9b0bb9be40e5","96aad332-da6b-4096-87b9-deb2320bd161","db582df6-3420-4ed9-a445-441321b8a1fc","719d2438-1d1f-406f-84a8-4c6fd3451852"],"responses":{"200":"fa845036-26c8-466c-9443-a13e9e9ae645","422":"97949b42-bb7e-4a44-a889-18bef0ffc45e"},"tags":["carrier","Files"],"summary":"List Carrier Files","description":"Returns raw invoice files (CSV, PDF, etc.) from the carrier connection, each with\na presigned download URL. Filter with created_date to select a time range.\nSubscribe to the carrier-file.created webhook to be notified when a new file is\navailable, then fetch that file from /carrier/files/{id} for a fresh URL instead\nof polling.","operationId":"get_carrier_get_files","method":"get","type":"path","servers":["1381fcaa-0832-4818-962f-e90769f3136d"],"security":[],"path":"/carrier/files","baseUrlOptions":["https://production.trackstarhq.com"],"title":"List Carrier Files","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"c2ebfcbb-6c0d-4f15-a636-deab4867af44":{"in":"header","name":"x-trackstar-api-key","description":"Your organization-level Trackstar API key.","schema":{"type":"string","example":"\u003cx-trackstar-api-key>","isRequired":true,"description":"Your organization-level Trackstar API key.","uniqueKey":"","typeLabel":"string"},"required":true},"60751e0e-a545-45b3-979a-233f9ff351ab":{"in":"header","name":"x-trackstar-access-token","description":"Your user's access token for a specific integration (ShipHero, Extensiv, etc).","schema":{"type":"string","example":"\u003cx-trackstar-access-token>","isRequired":true,"description":"Your user's access token for a specific integration (ShipHero, Extensiv, etc).","uniqueKey":"","typeLabel":"string"},"required":true},"abc090f2-623e-407a-bae2-cccebeb922c3":{"in":"query","name":"page_token","description":"The page token to use to retrieve the next page of results. If this field is omitted, there are no subsequent pages.","schema":{"oneOf":[{"type":"string","example":"page_token","description":"The page token to use to retrieve the next page of results. If this field is omitted, there are no subsequent pages.","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","example":"page_token","description":"The page token to use to retrieve the next page of results. If this field is omitted, there are no subsequent pages.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"required":false},"ea139862-683d-472a-b2f0-70b6e6dbfabf":{"in":"query","name":"limit","description":"The maximum number of items to return. The default is 1000.","schema":{"type":"integer","minimum":1,"maximum":1000,"example":1000,"isRequired":false,"description":"The maximum number of items to return. The default is 1000.","uniqueKey":"","typeLabel":"integer"},"required":false},"7c9a4fae-a029-4254-bb78-8a4f75268ff4":{"in":"query","name":"ids","schema":{"type":"object","properties":{"in":{"type":"array","minItems":1,"description":"A comma-separated list of resource IDs. If provided, all other query params are ignored.","example":"resource_id_1,resource_id_2","items":{"type":"string","description":"","example":"_in","uniqueKey":"in.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"in","typeLabel":"string[]"}},"required":["in"],"additionalProperties":false,"title":"CarrierFileIdsQueryParam","isRequired":false,"uniqueKey":"","typeLabel":"CarrierFileIdsQueryParam · object"},"required":false,"style":"deepObject","explode":true},"88aab8f4-1444-43af-8d26-426b93e71ca1":{"in":"query","name":"created_date","description":"Use this parameter to retrieve items filtered to a specific date range. For example, to get all items between 2023-03-10 and 2023-03-22, you would send `created_date[gte]=2023-03-10T00:00:00Z\u0026created_date[lte]=2023-03-22T00:00:00Z.` See the [filtering docs](/how-to-guides/about-the-api#filtering) for more. The date format must always be YYYY-MM-DDTHH:MM:SSZ. \n Note: it is much more efficient to use a combination of `gte`/`lte` than it is to use `gt`/`lt`.","schema":{"type":"object","properties":{"eq":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"eq","typeLabel":"string\u003cdate-time>"},"neq":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"neq","typeLabel":"string\u003cdate-time>"},"in":{"type":"array","minItems":1,"description":"Comma-separated.","items":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"in.items.[INDEX]","typeLabel":"string\u003cdate-time>"},"uniqueKey":"in","typeLabel":"string\u003cdate-time>[]"},"nin":{"type":"array","minItems":1,"description":"Comma-separated.","items":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"nin.items.[INDEX]","typeLabel":"string\u003cdate-time>"},"uniqueKey":"nin","typeLabel":"string\u003cdate-time>[]"},"gt":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"gt","typeLabel":"string\u003cdate-time>"},"gte":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"gte","typeLabel":"string\u003cdate-time>"},"lt":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"lt","typeLabel":"string\u003cdate-time>"},"lte":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"lte","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"title":"CarrierFileCreated_DateQueryParam","isRequired":false,"description":"Use this parameter to retrieve items filtered to a specific date range. For example, to get all items between 2023-03-10 and 2023-03-22, you would send `created_date[gte]=2023-03-10T00:00:00Z\u0026created_date[lte]=2023-03-22T00:00:00Z.` See the [filtering docs](/how-to-guides/about-the-api#filtering) for more. The date format must always be YYYY-MM-DDTHH:MM:SSZ. \n Note: it is much more efficient to use a combination of `gte`/`lte` than it is to use `gt`/`lt`.","uniqueKey":"","typeLabel":"CarrierFileCreated_DateQueryParam · object"},"required":false,"style":"deepObject","explode":true},"3201ab48-9cef-4067-983c-cb201507d746":{"in":"query","name":"updated_date","description":"Same syntax as `created_date`.","schema":{"type":"object","properties":{"eq":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"eq","typeLabel":"string\u003cdate-time>"},"neq":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"neq","typeLabel":"string\u003cdate-time>"},"in":{"type":"array","minItems":1,"description":"Comma-separated.","items":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"in.items.[INDEX]","typeLabel":"string\u003cdate-time>"},"uniqueKey":"in","typeLabel":"string\u003cdate-time>[]"},"nin":{"type":"array","minItems":1,"description":"Comma-separated.","items":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"nin.items.[INDEX]","typeLabel":"string\u003cdate-time>"},"uniqueKey":"nin","typeLabel":"string\u003cdate-time>[]"},"gt":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"gt","typeLabel":"string\u003cdate-time>"},"gte":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"gte","typeLabel":"string\u003cdate-time>"},"lt":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"lt","typeLabel":"string\u003cdate-time>"},"lte":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"lte","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"title":"CarrierFileUpdated_DateQueryParam","isRequired":false,"description":"Same syntax as `created_date`.","uniqueKey":"","typeLabel":"CarrierFileUpdated_DateQueryParam · object"},"required":false,"style":"deepObject","explode":true},"72f31e16-7d2d-4d5b-9383-b2f741dcc92f":{"in":"query","name":"trackstar_created_date","description":"Same syntax as `created_date`.","schema":{"type":"object","properties":{"eq":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"eq","typeLabel":"string\u003cdate-time>"},"neq":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"neq","typeLabel":"string\u003cdate-time>"},"in":{"type":"array","minItems":1,"description":"Comma-separated.","items":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"in.items.[INDEX]","typeLabel":"string\u003cdate-time>"},"uniqueKey":"in","typeLabel":"string\u003cdate-time>[]"},"nin":{"type":"array","minItems":1,"description":"Comma-separated.","items":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"nin.items.[INDEX]","typeLabel":"string\u003cdate-time>"},"uniqueKey":"nin","typeLabel":"string\u003cdate-time>[]"},"gt":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"gt","typeLabel":"string\u003cdate-time>"},"gte":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"gte","typeLabel":"string\u003cdate-time>"},"lt":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"lt","typeLabel":"string\u003cdate-time>"},"lte":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"lte","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"title":"CarrierFileTrackstar_Created_DateQueryParam","isRequired":false,"description":"Same syntax as `created_date`.","uniqueKey":"","typeLabel":"CarrierFileTrackstar_Created_DateQueryParam · object"},"required":false,"style":"deepObject","explode":true},"de6aa1f7-70e3-4b4e-a066-d4a96f0ae4d1":{"in":"query","name":"trackstar_updated_date","description":"Same syntax as `created_date`.","schema":{"type":"object","properties":{"eq":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"eq","typeLabel":"string\u003cdate-time>"},"neq":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"neq","typeLabel":"string\u003cdate-time>"},"in":{"type":"array","minItems":1,"description":"Comma-separated.","items":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"in.items.[INDEX]","typeLabel":"string\u003cdate-time>"},"uniqueKey":"in","typeLabel":"string\u003cdate-time>[]"},"nin":{"type":"array","minItems":1,"description":"Comma-separated.","items":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"nin.items.[INDEX]","typeLabel":"string\u003cdate-time>"},"uniqueKey":"nin","typeLabel":"string\u003cdate-time>[]"},"gt":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"gt","typeLabel":"string\u003cdate-time>"},"gte":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"gte","typeLabel":"string\u003cdate-time>"},"lt":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"lt","typeLabel":"string\u003cdate-time>"},"lte":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","uniqueKey":"lte","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"title":"CarrierFileTrackstar_Updated_DateQueryParam","isRequired":false,"description":"Same syntax as `created_date`.","uniqueKey":"","typeLabel":"CarrierFileTrackstar_Updated_DateQueryParam · object"},"required":false,"style":"deepObject","explode":true},"39869061-37e7-4cb1-b87d-9b0bb9be40e5":{"in":"query","name":"file_name","description":"Filter by file name (matches names containing the value). \n This filter is not indexed. Pair it with an indexed filter (`updated_date`, `created_date`, `trackstar_updated_date`, `trackstar_created_date`) using eq, gt, gte, lt or lte for faster, fuller pages. See [filtering docs](/how-to-guides/about-the-api#filtering).","schema":{"type":"object","properties":{"eq":{"type":"string","description":"","example":"invoice.csv","uniqueKey":"eq","typeLabel":"string"},"neq":{"type":"string","description":"","example":"neq","uniqueKey":"neq","typeLabel":"string"},"in":{"type":"array","minItems":1,"description":"Comma-separated.","items":{"type":"string","description":"","example":"_in","uniqueKey":"in.items.[INDEX]","typeLabel":"string"},"uniqueKey":"in","typeLabel":"string[]"},"nin":{"type":"array","minItems":1,"description":"Comma-separated.","items":{"type":"string","description":"","example":"nin","uniqueKey":"nin.items.[INDEX]","typeLabel":"string"},"uniqueKey":"nin","typeLabel":"string[]"},"contains":{"type":"string","description":"","example":"contains","uniqueKey":"contains","typeLabel":"string"},"not_contains":{"type":"string","description":"","example":"not_contains","uniqueKey":"not_contains","typeLabel":"string"}},"additionalProperties":false,"title":"CarrierFileFile_NameQueryParam","isRequired":false,"description":"Filter by file name (matches names containing the value). \n This filter is not indexed. Pair it with an indexed filter (`updated_date`, `created_date`, `trackstar_updated_date`, `trackstar_created_date`) using eq, gt, gte, lt or lte for faster, fuller pages. See [filtering docs](/how-to-guides/about-the-api#filtering).","uniqueKey":"","typeLabel":"CarrierFileFile_NameQueryParam · object"},"required":false,"style":"deepObject","explode":true},"96aad332-da6b-4096-87b9-deb2320bd161":{"in":"query","name":"file_type","description":"Filter by the file extension. \n This filter is not indexed. Pair it with an indexed filter (`updated_date`, `created_date`, `trackstar_updated_date`, `trackstar_created_date`) using eq, gt, gte, lt or lte for faster, fuller pages. See [filtering docs](/how-to-guides/about-the-api#filtering).","schema":{"type":"object","properties":{"eq":{"type":"string","description":"","example":"csv","uniqueKey":"eq","typeLabel":"string"},"neq":{"type":"string","description":"","example":"neq","uniqueKey":"neq","typeLabel":"string"},"in":{"type":"array","minItems":1,"description":"Comma-separated.","items":{"type":"string","description":"","example":"_in","uniqueKey":"in.items.[INDEX]","typeLabel":"string"},"uniqueKey":"in","typeLabel":"string[]"},"nin":{"type":"array","minItems":1,"description":"Comma-separated.","items":{"type":"string","description":"","example":"nin","uniqueKey":"nin.items.[INDEX]","typeLabel":"string"},"uniqueKey":"nin","typeLabel":"string[]"},"contains":{"type":"string","description":"","example":"contains","uniqueKey":"contains","typeLabel":"string"},"not_contains":{"type":"string","description":"","example":"not_contains","uniqueKey":"not_contains","typeLabel":"string"}},"additionalProperties":false,"title":"CarrierFileFile_TypeQueryParam","isRequired":false,"description":"Filter by the file extension. \n This filter is not indexed. Pair it with an indexed filter (`updated_date`, `created_date`, `trackstar_updated_date`, `trackstar_created_date`) using eq, gt, gte, lt or lte for faster, fuller pages. See [filtering docs](/how-to-guides/about-the-api#filtering).","uniqueKey":"","typeLabel":"CarrierFileFile_TypeQueryParam · object"},"required":false,"style":"deepObject","explode":true},"db582df6-3420-4ed9-a445-441321b8a1fc":{"in":"query","name":"start_time","description":"Deprecated: use created_date[gte] instead.","schema":{"type":"string","format":"date-time","example":"2023-03-15T13:45:30Z","isRequired":false,"description":"Deprecated: use created_date[gte] instead.","uniqueKey":"","typeLabel":"string\u003cdate-time>"},"required":false},"719d2438-1d1f-406f-84a8-4c6fd3451852":{"in":"query","name":"end_time","description":"Deprecated: use created_date[lte] instead.","schema":{"type":"string","format":"date-time","example":"2023-03-15T13:45:30Z","isRequired":false,"description":"Deprecated: use created_date[lte] instead.","uniqueKey":"","typeLabel":"string\u003cdate-time>"},"required":false}},"responses":{"fa845036-26c8-466c-9443-a13e9e9ae645":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique ID of the file.","example":"2025-11-15T00:00:00/crawl_id/invoice.csv","isRequired":true,"uniqueKey":"data.items.[INDEX].id","typeLabel":"string"},"created_date":{"type":"string","format":"date-time","description":"The date the file was created.","example":"2022-01-01T00:00:00Z","isRequired":true,"uniqueKey":"data.items.[INDEX].created_date","typeLabel":"string\u003cdate-time>"},"updated_date":{"type":"string","format":"date-time","description":"The date the file was last updated.","example":"2022-01-02T05:05:05Z","isRequired":true,"uniqueKey":"data.items.[INDEX].updated_date","typeLabel":"string\u003cdate-time>"},"file_name":{"type":"string","description":"The file name.","example":"invoice.csv","isRequired":true,"uniqueKey":"data.items.[INDEX].file_name","typeLabel":"string"},"file_type":{"oneOf":[{"type":"string","description":"The file extension.","example":"csv","isRequired":true,"uniqueKey":"data.items.[INDEX].file_type.oneOf.0","typeLabel":"string"},{"type":"null","description":"The file extension.","example":"csv","isRequired":true,"uniqueKey":"data.items.[INDEX].file_type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].file_type","typeLabel":"string | null"},"trackstar_created_date":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","isRequired":true,"uniqueKey":"data.items.[INDEX].trackstar_created_date","typeLabel":"string\u003cdate-time>"},"trackstar_updated_date":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","isRequired":true,"uniqueKey":"data.items.[INDEX].trackstar_updated_date","typeLabel":"string\u003cdate-time>"},"download_url":{"type":"string","description":"Presigned download URL (valid for 20 minutes).","example":"https://s3.amazonaws.com/...","isRequired":true,"uniqueKey":"data.items.[INDEX].download_url","typeLabel":"string"},"download_url_expires_at":{"type":"string","format":"date-time","description":"Expiration timestamp for the download URL.","example":"2025-01-15T10:50:00Z","isRequired":true,"uniqueKey":"data.items.[INDEX].download_url_expires_at","typeLabel":"string\u003cdate-time>"}},"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","uniqueKey":"data.items.[INDEX]","typeLabel":"CarrierFileWithUrlSchema · object"},"isRequired":true,"uniqueKey":"data","typeLabel":"CarrierFileWithUrlSchema · object[]"},"next_token":{"oneOf":[{"type":"string","description":"See [pagination](/how-to-guides/about-the-api#pagination) for more details.","example":"next_token","isRequired":true,"uniqueKey":"next_token.oneOf.0","typeLabel":"string"},{"type":"null","description":"See [pagination](/how-to-guides/about-the-api#pagination) for more details.","example":"next_token","isRequired":true,"uniqueKey":"next_token.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"next_token","typeLabel":"string | null"},"total_count":{"type":"integer","description":"The number of items returned.","example":1,"isRequired":true,"uniqueKey":"total_count","typeLabel":"integer"}},"required":["data","next_token","total_count"],"additionalProperties":false,"title":"CarrierFilesListEndpoint","uniqueKey":"","typeLabel":"CarrierFilesListEndpoint · object"},"examples":{"Example":{"title":"Example","value":{"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"}],"next_token":"next_token","total_count":1}}},"exampleType":"generated"}},"description":"Successful response","exampleType":"generated"},"97949b42-bb7e-4a44-a889-18bef0ffc45e":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"detail":{"type":"object","properties":{"\u003clocation>":{"type":"object","properties":{"\u003cfield_name>":{"type":"array","items":{"type":"string","uniqueKey":"detail.\u003clocation>.\u003cfield_name>.items.[INDEX]","typeLabel":"string"},"uniqueKey":"detail.\u003clocation>.\u003cfield_name>","typeLabel":"string[]"}},"uniqueKey":"detail.\u003clocation>","typeLabel":"object"}},"uniqueKey":"detail","typeLabel":"object"}},"required":["error"],"type":"object","title":"ValidationError","uniqueKey":"","typeLabel":"ValidationError · object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","detail":{"\u003clocation>":{"\u003cfield_name>":["\u003cstring>"]}}}}},"exampleType":"generated"}},"description":"Validation error","exampleType":"generated"}},"security":{},"servers":{"1381fcaa-0832-4818-962f-e90769f3136d":{"description":"Trackstar API","url":"https://production.trackstarhq.com"}}},"originalFileLocation":"https://production.trackstarhq.com/openapi.json"},"subdomain":"trackstar","siteName":"Trackstar","title":"List Carrier Files - Trackstar","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-02T18:24:35.839Z","originalFileLocation":"api-reference/carrier-api/files/get.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Returns raw invoice files (CSV, PDF, etc.) from the carrier connection, each with a presigned download URL. Filter with created_date to select a time range. Subscribe to the carrier-file.created webhook to be notified when a new file is available, then fetch that file from /carrier/files/{id} for a fresh URL instead of polling.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Trackstar\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/trackstar/pv8TH9ZNYgztdvmO/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/trackstar/pv8TH9ZNYgztdvmO/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/trackstar/pv8TH9ZNYgztdvmO/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/trackstar/pv8TH9ZNYgztdvmO/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/trackstar/pv8TH9ZNYgztdvmO/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/trackstar/pv8TH9ZNYgztdvmO/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/trackstar/pv8TH9ZNYgztdvmO/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/trackstar/pv8TH9ZNYgztdvmO/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/trackstar/pv8TH9ZNYgztdvmO/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List Carrier Files - Trackstar\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns raw invoice files (CSV, PDF, etc.) from the carrier connection, each with a presigned download URL. Filter with created_date to select a time range. Subscribe to the carrier-file.created webhook to be notified when a new file is available, then fetch that file from /carrier/files/{id} for a fresh URL instead of polling.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Trackstar\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.trackstarhq.com/api-reference/carrier-api/files/get\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://trackstar.mintlify.app/_mintlify/api/og/v2?division=Files\u0026amp;title=List+Carrier+Files\u0026amp;description=Returns+raw+invoice+files+%28CSV%2C+PDF%2C+etc.%29+from+the+carrier+connection%2C+each+with%0Aa+presigned+download+URL.+Filter+with+created_date+to+select+a+time+range.%0ASub\u0026amp;theme=a7581761d745b5f6f24e3162\u0026amp;signature=1b2e5e1421f66b8a48b40230bc90312e52ff20fc2f48ac2714f4ef9dcdf305e9\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List Carrier Files - Trackstar\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns raw invoice files (CSV, PDF, etc.) from the carrier connection, each with a presigned download URL. Filter with created_date to select a time range. Subscribe to the carrier-file.created webhook to be notified when a new file is available, then fetch that file from /carrier/files/{id} for a fresh URL instead of polling.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://trackstar.mintlify.app/_mintlify/api/og/v2?division=Files\u0026amp;title=List+Carrier+Files\u0026amp;description=Returns+raw+invoice+files+%28CSV%2C+PDF%2C+etc.%29+from+the+carrier+connection%2C+each+with%0Aa+presigned+download+URL.+Filter+with+created_date+to+select+a+time+range.%0ASub\u0026amp;theme=a7581761d745b5f6f24e3162\u0026amp;signature=1b2e5e1421f66b8a48b40230bc90312e52ff20fc2f48ac2714f4ef9dcdf305e9\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/trackstar/pv8TH9ZNYgztdvmO/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Trackstar\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7691DA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.trackstarhq.com/api-reference/carrier-api/files/get\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/carrier-api/files/get.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.trackstarhq.com/#organization\",\"name\":\"Trackstar\",\"url\":\"https://docs.trackstarhq.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/trackstar/e_R8AMY4ayyVfYRU/logo/light.svg?fit=max\u0026auto=format\u0026n=e_R8AMY4ayyVfYRU\u0026q=85\u0026s=eb832f4ffc768291fd95c4939b2ac6c2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.trackstarhq.com#website\",\"name\":\"Trackstar\",\"url\":\"https://docs.trackstarhq.com\",\"publisher\":{\"@id\":\"https://docs.trackstarhq.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.trackstarhq.com/api-reference/carrier-api/files/get#webpage\",\"url\":\"https://docs.trackstarhq.com/api-reference/carrier-api/files/get\",\"name\":\"List Carrier Files\",\"description\":\"Returns raw invoice files (CSV, PDF, etc.) from the carrier connection, each with a presigned download URL. Filter with created_date to select a time range. Subscribe to the carrier-file.created webhook to be notified when a new file is available, then fetch that file from /carrier/files/{id} for a fresh URL instead of polling.\",\"dateModified\":\"2026-09-02T18:24:35.839Z\",\"isPartOf\":{\"@id\":\"https://docs.trackstarhq.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.trackstarhq.com/api-reference/carrier-api/files/get#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.trackstarhq.com/api-reference/carrier-api/files/get#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Carrier API Reference\",\"item\":\"https://docs.trackstarhq.com/api-reference/carrier-api/invoice-line-items/info\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Files\",\"item\":\"https://docs.trackstarhq.com/api-reference/carrier-api/files/info\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"List Carrier Files\",\"item\":\"https://docs.trackstarhq.com/api-reference/carrier-api/files/get\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.trackstarhq.com/api-reference/carrier-api/files/get#apireference\",\"headline\":\"List Carrier Files\",\"name\":\"List Carrier Files\",\"description\":\"Returns raw invoice files (CSV, PDF, etc.) from the carrier connection, each with a presigned download URL. Filter with created_date to select a time range. Subscribe to the carrier-file.created webhook to be notified when a new file is available, then fetch that file from /carrier/files/{id} for a fresh URL instead of polling.\",\"url\":\"https://docs.trackstarhq.com/api-reference/carrier-api/files/get\",\"mainEntityOfPage\":{\"@id\":\"https://docs.trackstarhq.com/api-reference/carrier-api/files/get#webpage\"},\"dateModified\":\"2026-09-02T18:24:35.839Z\",\"publisher\":{\"@id\":\"https://docs.trackstarhq.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.trackstarhq.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Trackstar\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Trackstar","nav":{"global":{"anchors":[{"anchor":"Request an API Key","icon":"key","href":"https://trackstarhq.com/get-started"},{"anchor":"Login to Dashboard","icon":"browser","href":"https://dashboard.trackstarhq.com"},{"anchor":"WMS Integrations","icon":"warehouse","href":"https://trackstarhq.com/integrations/wms"},{"anchor":"Cart Integrations","icon":"cart-shopping","href":"https://trackstarhq.com/integrations/cart"},{"anchor":"Carrier Integrations","icon":"truck","href":"https://trackstarhq.com/integrations/carrier"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"Admin API","pages":[{"title":"Admin API","href":"/api-reference/mgmt/create-link-token"}]},{"tab":"WMS API","pages":[{"title":"WMS API","href":"/api-reference/wms-api/inventory/info"}]},{"tab":"Cart API","pages":[{"title":"Cart API","href":"/api-reference/cart-api/products/info"}]},{"tab":"Carrier API","groups":[{"group":"Carrier API Reference","pages":[{"group":"Invoice Line Items","pages":[{"title":"Invoice Line Items","href":"/api-reference/carrier-api/invoice-line-items/info"},{"openapi":"get /carrier/invoice-line-items","title":"Get All Invoice Line Items","href":"/api-reference/carrier-api/invoice-line-items/get"},{"openapi":"get /carrier/invoice-line-items/{invoice_line_item_id}","title":"Get Invoice Line Item","href":"/api-reference/carrier-api/invoice-line-items/get-item"},{"openapi":"put /carrier/invoice-line-items/{invoice_line_item_id}/trackstar-tags","title":"Update Invoice Line Item Trackstar Tags","href":"/api-reference/carrier-api/invoice-line-items/add-tag"}]},{"group":"Files","pages":[{"title":"Files","description":"Raw carrier invoice files with presigned download links","href":"/api-reference/carrier-api/files/info"},{"openapi":"get /carrier/files","title":"List Carrier Files","href":"/api-reference/carrier-api/files/get"},{"openapi":"get /carrier/files/{file_id}","title":"Get Carrier File","description":"Returns a single raw file for the Carrier connection with the associated id, with a\nfreshly minted download URL. This is what the carrier-file.created webhook points\nat: the webhook carries the file's id, and the URL is minted here because a\npresigned URL expires faster than a webhook can be retried.","href":"/api-reference/carrier-api/files/get-item"},{"group":"Sample Files","pages":[{"title":"Sample Files Overview","href":"/api-reference/carrier-api/sample-files/overview"},{"title":"DHL eCommerce","href":"/api-reference/carrier-api/sample-files/dhl-ecom"},{"title":"DHL Express","href":"/api-reference/carrier-api/sample-files/dhl-express"},{"title":"DPD","href":"/api-reference/carrier-api/sample-files/dpd"},{"title":"FedEx","href":"/api-reference/carrier-api/sample-files/fedex"},{"title":"Royal Mail","href":"/api-reference/carrier-api/sample-files/royal-mail"},{"title":"UPS","href":"/api-reference/carrier-api/sample-files/ups"},{"title":"USPS","href":"/api-reference/carrier-api/sample-files/usps"}]}]}]}]},{"tab":"ERP API","hidden":true,"pages":[{"title":"ERP API","href":"/api-reference/erp-api/sales-orders/info"}]}]},"basePath":"","title":"List Carrier Files - Trackstar","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}