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.
{"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":"6ae4f3ab7acf49fac9da16ec","collectionId":"8357bb4d-ef58-4cad-9f49-3af74e319ee4","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae4f3ab7acf49fac9da16ec"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae4f3ab7acf49fac9da16ec","clientVersion":"0.0.4044","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-item","slug":"/api-reference/carrier-api/files/get-item","pageMetadata":{"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"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"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.\"\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/{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"}}},"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":["b1b86db6-b079-4a38-9281-43c722ee171c","459f9447-eb81-4794-a4db-54bb33d9a822","ef2393ff-3a6f-4a78-97f4-93fd9c2d2fe9"],"responses":{"200":"8fb87196-9248-4251-8399-38d0ed25db31","404":"d253d990-6674-416a-9b79-aad1fd87ce1d","422":"bc55a8a0-3b88-44dc-be34-af31159c5e60"},"tags":["carrier","Files"],"summary":"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.","operationId":"get_carrier_get_file","method":"get","type":"path","servers":["eb5659b4-6eec-462c-991a-7da8383bb677"],"security":[],"path":"/carrier/files/{file_id}","baseUrlOptions":["https://production.trackstarhq.com"],"title":"Get Carrier File","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"b1b86db6-b079-4a38-9281-43c722ee171c":{"in":"path","name":"file_id","schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true},"459f9447-eb81-4794-a4db-54bb33d9a822":{"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},"ef2393ff-3a6f-4a78-97f4-93fd9c2d2fe9":{"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}},"responses":{"8fb87196-9248-4251-8399-38d0ed25db31":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"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.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.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.updated_date","typeLabel":"string\u003cdate-time>"},"file_name":{"type":"string","description":"The file name.","example":"invoice.csv","isRequired":true,"uniqueKey":"data.file_name","typeLabel":"string"},"file_type":{"oneOf":[{"type":"string","description":"The file extension.","example":"csv","isRequired":true,"uniqueKey":"data.file_type.oneOf.0","typeLabel":"string"},{"type":"null","description":"The file extension.","example":"csv","isRequired":true,"uniqueKey":"data.file_type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.file_type","typeLabel":"string | null"},"trackstar_created_date":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","isRequired":true,"uniqueKey":"data.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.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.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.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","typeLabel":"CarrierFileWithUrlSchema · object"}},"additionalProperties":false,"title":"CarrierFilesSingleItemEndpoint","uniqueKey":"","typeLabel":"CarrierFilesSingleItemEndpoint · 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"}}}},"exampleType":"generated"}},"description":"Successful response","exampleType":"generated"},"d253d990-6674-416a-9b79-aad1fd87ce1d":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"id":{"type":"string","description":"The ID of the item that wasn't found.","uniqueKey":"id","typeLabel":"string"}},"required":["error"],"type":"object","title":"HTTPError","uniqueKey":"","typeLabel":"HTTPError · object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","id":"\u003cstring>"}}},"exampleType":"generated"}},"description":"Not found","exampleType":"generated"},"bc55a8a0-3b88-44dc-be34-af31159c5e60":{"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":{"eb5659b4-6eec-462c-991a-7da8383bb677":{"description":"Trackstar API","url":"https://production.trackstarhq.com"}}},"originalFileLocation":"https://production.trackstarhq.com/openapi.json"},"subdomain":"trackstar","siteName":"Trackstar","title":"Get Carrier File - Trackstar","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-02T22:07:58.400Z","originalFileLocation":"api-reference/carrier-api/files/get-item.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 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\u0026#x27;s id, and the URL is minted here because a presigned URL expires faster than a webhook can be retried.\">\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=\"Get Carrier File - Trackstar\">\u003cmeta data-mint-head property=\"og:description\" content=\"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\u0026#x27;s id, and the URL is minted here because a presigned URL expires faster than a webhook can be retried.\">\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-item\">\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=Get+Carrier+File\u0026amp;description=Returns+a+single+raw+file+for+the+Carrier+connection+with+the+associated+id%2C+with+a%0Afreshly+minted+download+URL.+This+is+what+the+carrier-file.created+webhook+p\u0026amp;theme=a7581761d745b5f6f24e3162\u0026amp;signature=ff33181d40c4b504ae6becee2b7c79220d4fa51dc775c047e5f9991eb752d508\">\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=\"Get Carrier File - Trackstar\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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\u0026#x27;s id, and the URL is minted here because a presigned URL expires faster than a webhook can be retried.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://trackstar.mintlify.app/_mintlify/api/og/v2?division=Files\u0026amp;title=Get+Carrier+File\u0026amp;description=Returns+a+single+raw+file+for+the+Carrier+connection+with+the+associated+id%2C+with+a%0Afreshly+minted+download+URL.+This+is+what+the+carrier-file.created+webhook+p\u0026amp;theme=a7581761d745b5f6f24e3162\u0026amp;signature=ff33181d40c4b504ae6becee2b7c79220d4fa51dc775c047e5f9991eb752d508\">\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-item\">\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-item.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-item#webpage\",\"url\":\"https://docs.trackstarhq.com/api-reference/carrier-api/files/get-item\",\"name\":\"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.\",\"dateModified\":\"2026-09-02T22:07:58.400Z\",\"isPartOf\":{\"@id\":\"https://docs.trackstarhq.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.trackstarhq.com/api-reference/carrier-api/files/get-item#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.trackstarhq.com/api-reference/carrier-api/files/get-item#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\":\"Get Carrier File\",\"item\":\"https://docs.trackstarhq.com/api-reference/carrier-api/files/get-item\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.trackstarhq.com/api-reference/carrier-api/files/get-item#apireference\",\"headline\":\"Get Carrier File\",\"name\":\"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.\",\"url\":\"https://docs.trackstarhq.com/api-reference/carrier-api/files/get-item\",\"mainEntityOfPage\":{\"@id\":\"https://docs.trackstarhq.com/api-reference/carrier-api/files/get-item#webpage\"},\"dateModified\":\"2026-09-02T22:07:58.400Z\",\"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","href":"/api-reference/carrier-api/files/info"},{"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"},{"openapi":"get /carrier/files/{file_id}","title":"Get Carrier File","href":"/api-reference/carrier-api/files/get-item"},{"group":"Sample Files","pages":[{"title":"Sample Files Overview","description":"Per-integration reference for the files each carrier delivers, with downloadable synthetic sample CSVs.","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"}]}]}]}]}]},"basePath":"","title":"Get Carrier File - Trackstar","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}