Fetch a single file transfer. This is the endpoint to poll after uploading: status stays pending until the target system has accepted the file, at which point it becomes delivered and remote_id holds the identifier the target assigned.
A record of one file Twine delivered to a target system. Twine does not keep uploaded files — they are removed shortly after delivery — but this record is kept, including the identifier the target system assigned to the document.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Twine Integrations","colors":{"primary":"#7600ff","light":"#ad66ff","dark":"#7600ff"},"logo":{"light":"https://mintcdn.com/entwineab/W0WCY-b2dvTokvLn/logo/light.svg?fit=max\u0026auto=format\u0026n=W0WCY-b2dvTokvLn\u0026q=85\u0026s=7e70d0ec35e8816f98a512eafa2ad35b","dark":"https://mintcdn.com/entwineab/W0WCY-b2dvTokvLn/logo/dark.svg?fit=max\u0026auto=format\u0026n=W0WCY-b2dvTokvLn\u0026q=85\u0026s=bcf15f923005d67de257a74c061db962"},"favicon":"https://mintcdn.com/entwineab/OPi-j2jbIEGoK6fy/favicon.svg?fit=max\u0026auto=format\u0026n=OPi-j2jbIEGoK6fy\u0026q=85\u0026s=190facce372d84ae3de157af3da0688e","navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"},{"href":"https://app-stage.twine.se","label":"Stage"}],"primary":{"type":"button","label":"App","href":"https://app.twine.se"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"twine.se","icon":"globe","href":"https://www.twine.se"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"entwineab","hasAudioNarration":false,"actualSubdomain":"entwineab","customDomains":["docs.twine.se"],"gitSource":{"type":"github","owner":"twine-se","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6acf668b4788a74327b72032","collectionId":"027bd1b7-2940-449a-bfcf-f8ccfca1f9a2","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6acf668b4788a74327b72032"},"entitlements":{},"buildId":"6acf668b4788a74327b72032","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"API Reference","count":149},{"language":"default","tag":"Data Engine","count":86},{"language":"default","tag":"Integrations","count":72},{"language":"default","tag":"Flow Engine","count":41},{"language":"default","tag":"Platform","count":33},{"language":"default","tag":"Assigns","count":28},{"language":"default","tag":"Flow Control","count":19},{"language":"default","tag":"Transformation","count":19},{"language":"default","tag":"Changelog","count":18},{"language":"default","tag":"HRIS","count":14}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/file-transfers/get-file-transfer","slug":"/api-reference/file-transfers/get-file-transfer","pageMetadata":{"title":"Get File Transfer","description":"Fetch a single file transfer. This is the endpoint to poll after uploading: `status` stays `pending` until the target system has accepted the file, at which point it becomes `delivered` and `remote_id` holds the identifier the target assigned.","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/file-transfers/{file_transfer_id}","href":"/api-reference/file-transfers/get-file-transfer","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Fetch a single file transfer. This is the endpoint to poll after uploading: \", _jsx(_components.code, {\n children: \"status\"\n }), \" stays \", _jsx(_components.code, {\n children: \"pending\"\n }), \" until the target system has accepted the file, at which point it becomes \", _jsx(_components.code, {\n children: \"delivered\"\n }), \" and \", _jsx(_components.code, {\n children: \"remote_id\"\n }), \" holds the identifier the target assigned.\"]\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":{"title":"Get File Transfer","description":"Fetch a single file transfer. This is the endpoint to poll after uploading: `status` stays `pending` until the target system has accepted the file, at which point it becomes `delivered` and `remote_id` holds the identifier the target assigned.","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/file-transfers/{file_transfer_id}","href":"/api-reference/file-transfers/get-file-transfer","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"callbacks":{},"description":"Fetch a single file transfer. This is the endpoint to poll after uploading: `status` stays `pending` until the target system has accepted the file, at which point it becomes `delivered` and `remote_id` holds the identifier the target assigned.","operationId":"getFileTransfer","parameters":["905d7d6c-8178-43d2-872f-715d78e02288"],"responses":{"200":"2e81800d-9f4c-417a-bcfc-0ef4158051ad","400":"0d67c901-bc27-45a5-b4ac-547326c58725","403":"9dccd9a8-4f5b-49ca-a8f4-8420ce153b31","404":"bf2eab07-2501-438a-97ba-2c568a6ead8a","500":"9735cb14-31c2-49c5-a981-01dc7a951efd"},"summary":"Get File Transfer","tags":["File Transfers"],"method":"get","type":"path","servers":["9052e5c0-34df-47d4-8603-693bab08bcc0","c9338b87-25eb-4aa8-b3fe-b99dae164f43"],"security":["48248fe8-3acb-4be1-b40f-8384723ebc05"],"path":"/v1/org/file-transfers/{file_transfer_id}","baseUrlOptions":["https://api.twine.se","https://api-stage.twine.se"],"title":"Get File Transfer","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"905d7d6c-8178-43d2-872f-715d78e02288":{"description":"","in":"path","name":"file_transfer_id","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"2e81800d-9f4c-417a-bcfc-0ef4158051ad":{"content":{"application/json":{"schema":{"description":"A file transfer response","properties":{"data":{"description":"A record of one file Twine delivered to a target system. Twine does not keep uploaded files — they are removed shortly after delivery — but this record is kept, including the identifier the target system assigned to the document.","properties":{"file_name":{"description":"The uploaded file's name","example":"first-aid-2026.pdf","type":"string","isRequired":true,"uniqueKey":"data.file_name","typeLabel":"string"},"id":{"description":"File transfer UUID","format":"uuid","type":"string","isRequired":true,"uniqueKey":"data.id","typeLabel":"string\u003cuuid>"},"org_id":{"description":"Organization UUID","format":"uuid","type":"string","isRequired":true,"uniqueKey":"data.org_id","typeLabel":"string\u003cuuid>"},"status":{"description":"Where the transfer has got to.\n\n- `pending` — accepted and on its way to the target. Poll until this changes.\n- `delivered` — the target accepted the file. `remote_id` and `remote_path` hold whatever identifier it returned.\n- `rejected` — the file reached the target's domain mapping but was deliberately not sent: a condition on the system integration or domain mapping excluded it, or that mapping is disabled. Nothing malfunctioned, so there is no error to look up.\n- `failed` — delivery was attempted and did not succeed. Look up `job_id` under `/v1/org/jobs` for the reason.\n- `undeliverable` — no file transfer domain mapping from Twine matched, so nothing was sent. The file was recorded but never delivered.\n- `unknown` — the underlying job record is no longer available. This record outlives the job, so a very old transfer can end up here.\n\nDerived from the delivery job rather than stored, so it cannot be filtered on.\n","enum":["pending","delivered","rejected","failed","undeliverable","unknown"],"example":"delivered","type":"string","isRequired":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"bytes_retain_until":{"oneOf":[{"description":"When the uploaded file itself is removed. This record and the identifiers on it are kept indefinitely; the file is not.","format":"date-time","type":"string","uniqueKey":"data.bytes_retain_until.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"When the uploaded file itself is removed. This record and the identifiers on it are kept indefinitely; the file is not.","format":"date-time","type":"null","uniqueKey":"data.bytes_retain_until.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.bytes_retain_until","typeLabel":"string\u003cdate-time> | null"},"content_sha256":{"oneOf":[{"description":"SHA-256 of the uploaded file, hex encoded. Useful for verifying what was sent.","type":"string","uniqueKey":"data.content_sha256.oneOf.0","typeLabel":"string"},{"description":"SHA-256 of the uploaded file, hex encoded. Useful for verifying what was sent.","type":"null","uniqueKey":"data.content_sha256.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.content_sha256","typeLabel":"string | null"},"content_type":{"oneOf":[{"example":"application/pdf","type":"string","uniqueKey":"data.content_type.oneOf.0","typeLabel":"string"},{"example":"application/pdf","type":"null","uniqueKey":"data.content_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.content_type","typeLabel":"string | null"},"delivered_at":{"oneOf":[{"description":"When the target accepted the file.","format":"date-time","type":"string","uniqueKey":"data.delivered_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"When the target accepted the file.","format":"date-time","type":"null","uniqueKey":"data.delivered_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.delivered_at","typeLabel":"string\u003cdate-time> | null"},"delivery_job_id":{"oneOf":[{"description":"The job that performed the upload to the target, once one has run.","format":"uuid","type":"string","uniqueKey":"data.delivery_job_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"description":"The job that performed the upload to the target, once one has run.","format":"uuid","type":"null","uniqueKey":"data.delivery_job_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.delivery_job_id","typeLabel":"string\u003cuuid> | null"},"domain_mapping_id":{"oneOf":[{"description":"The domain mapping used to deliver the file.","format":"uuid","type":"string","uniqueKey":"data.domain_mapping_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"description":"The domain mapping used to deliver the file.","format":"uuid","type":"null","uniqueKey":"data.domain_mapping_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.domain_mapping_id","typeLabel":"string\u003cuuid> | null"},"employee_id":{"oneOf":[{"description":"The Twine employee the document belongs to, if any. Twine resolves this to the employee's id in the target system when delivering.","format":"uuid","type":"string","uniqueKey":"data.employee_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"description":"The Twine employee the document belongs to, if any. Twine resolves this to the employee's id in the target system when delivering.","format":"uuid","type":"null","uniqueKey":"data.employee_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.employee_id","typeLabel":"string\u003cuuid> | null"},"idempotency_key":{"oneOf":[{"type":"string","uniqueKey":"data.idempotency_key.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.idempotency_key.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.idempotency_key","typeLabel":"string | null"},"inserted_at":{"format":"date-time","type":"string","uniqueKey":"data.inserted_at","typeLabel":"string\u003cdate-time>"},"job_id":{"oneOf":[{"description":"The job that carried out the transfer. Look it up under `/v1/org/jobs` for detail.","format":"uuid","type":"string","uniqueKey":"data.job_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"description":"The job that carried out the transfer. Look it up under `/v1/org/jobs` for detail.","format":"uuid","type":"null","uniqueKey":"data.job_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.job_id","typeLabel":"string\u003cuuid> | null"},"metadata":{"additionalProperties":true,"description":"The metadata supplied on upload, returned unchanged.","type":"object","uniqueKey":"data.metadata","typeLabel":"object"},"remote_employee_id":{"oneOf":[{"description":"The employee's id in the target system, when the document hangs off an employee there. Some targets only address a document as the pair of this and `remote_id`.","example":"E-10422","type":"string","uniqueKey":"data.remote_employee_id.oneOf.0","typeLabel":"string"},{"description":"The employee's id in the target system, when the document hangs off an employee there. Some targets only address a document as the pair of this and `remote_id`.","example":"E-10422","type":"null","uniqueKey":"data.remote_employee_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.remote_employee_id","typeLabel":"string | null"},"remote_id":{"oneOf":[{"description":"The identifier the target system assigned to the uploaded document. Null until the transfer is delivered, and also null afterwards for targets that do not return one (file area targets identify a document by path, and some HR systems return nothing at all on upload) — or when a document of that name was already present and the domain mapping does not overwrite, in which case nothing was uploaded and `remote_metadata.note` says so.","example":"3fa85f64-5717-4562-b3fc-2c963f66afa6","type":"string","uniqueKey":"data.remote_id.oneOf.0","typeLabel":"string"},{"description":"The identifier the target system assigned to the uploaded document. Null until the transfer is delivered, and also null afterwards for targets that do not return one (file area targets identify a document by path, and some HR systems return nothing at all on upload) — or when a document of that name was already present and the domain mapping does not overwrite, in which case nothing was uploaded and `remote_metadata.note` says so.","example":"3fa85f64-5717-4562-b3fc-2c963f66afa6","type":"null","uniqueKey":"data.remote_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.remote_id","typeLabel":"string | null"},"remote_metadata":{"additionalProperties":true,"description":"Any further identifying detail the target returned. May also carry a `note` explaining an outcome the other fields cannot express — notably a transfer that is `delivered` with no `remote_id` because a document of that name was already present and the domain mapping does not overwrite, so nothing was uploaded and the target was never asked for an identifier.","type":"object","uniqueKey":"data.remote_metadata","typeLabel":"object"},"remote_path":{"oneOf":[{"description":"Where the file landed in the target, for targets addressed by path rather than by id (SFTP, S3).","example":"/certificates/2026/first-aid-2026.pdf","type":"string","uniqueKey":"data.remote_path.oneOf.0","typeLabel":"string"},{"description":"Where the file landed in the target, for targets addressed by path rather than by id (SFTP, S3).","example":"/certificates/2026/first-aid-2026.pdf","type":"null","uniqueKey":"data.remote_path.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.remote_path","typeLabel":"string | null"},"size":{"oneOf":[{"description":"Size in bytes of the uploaded file","type":"integer","uniqueKey":"data.size.oneOf.0","typeLabel":"integer"},{"description":"Size in bytes of the uploaded file","type":"null","uniqueKey":"data.size.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.size","typeLabel":"integer | null"},"system_integration_id":{"oneOf":[{"description":"The target system integration the file was delivered to.","format":"uuid","type":"string","uniqueKey":"data.system_integration_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"description":"The target system integration the file was delivered to.","format":"uuid","type":"null","uniqueKey":"data.system_integration_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.system_integration_id","typeLabel":"string\u003cuuid> | null"},"updated_at":{"format":"date-time","type":"string","uniqueKey":"data.updated_at","typeLabel":"string\u003cdate-time>"}},"required":["id","org_id","file_name","status"],"title":"FileTransfer","type":"object","isRequired":true,"uniqueKey":"data","typeLabel":"FileTransfer · object"}},"required":["data"],"title":"FileTransferResponse","type":"object","uniqueKey":"","typeLabel":"FileTransferResponse · object"},"examples":{"Example":{"title":"Example","value":{"data":{"file_name":"first-aid-2026.pdf","id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","org_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"delivered","bytes_retain_until":"2023-11-07T05:31:56Z","content_sha256":"\u003cstring>","content_type":"application/pdf","delivered_at":"2023-11-07T05:31:56Z","delivery_job_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","domain_mapping_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","employee_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","idempotency_key":"\u003cstring>","inserted_at":"2023-11-07T05:31:56Z","job_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","metadata":{},"remote_employee_id":"E-10422","remote_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","remote_metadata":{},"remote_path":"/certificates/2026/first-aid-2026.pdf","size":123,"system_integration_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","updated_at":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"description":"Response","exampleType":"generated"},"0d67c901-bc27-45a5-b4ac-547326c58725":{"content":{"application/json":{"schema":{"description":"Bad request error","properties":{"code":{"example":400,"type":"integer","isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"errors":{"default":[],"items":{"description":"Singular error","properties":{"domain":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].domain","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"reason":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].reason","typeLabel":"string"}},"required":["domain","reason","message"],"title":"InnerError","type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"InnerError · object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"InnerError · object[]"},"message":{"example":"Bad Request","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["code","message","errors"],"title":"BadRequestError","type":"object","uniqueKey":"","typeLabel":"BadRequestError · object"},"examples":{"Example":{"title":"Example","value":{"code":400,"errors":[],"message":"Bad Request"}}},"exampleType":"generated"}},"description":"Bad Request Response","exampleType":"generated"},"9dccd9a8-4f5b-49ca-a8f4-8420ce153b31":{"content":{"application/json":{"schema":{"description":"Forbidden error","properties":{"code":{"example":403,"type":"integer","isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"errors":{"default":[],"items":{"description":"Singular error","properties":{"domain":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].domain","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"reason":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].reason","typeLabel":"string"}},"required":["domain","reason","message"],"title":"InnerError","type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"InnerError · object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"InnerError · object[]"},"message":{"example":"Forbidden","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["code","message","errors"],"title":"ForbiddenError","type":"object","uniqueKey":"","typeLabel":"ForbiddenError · object"},"examples":{"Example":{"title":"Example","value":{"code":403,"errors":[],"message":"Forbidden"}}},"exampleType":"generated"}},"description":"Forbidden Response","exampleType":"generated"},"bf2eab07-2501-438a-97ba-2c568a6ead8a":{"content":{"application/json":{"schema":{"description":"Resource not found error","properties":{"code":{"example":404,"type":"integer","isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"errors":{"default":[],"items":{"description":"Singular error","properties":{"domain":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].domain","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"reason":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].reason","typeLabel":"string"}},"required":["domain","reason","message"],"title":"InnerError","type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"InnerError · object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"InnerError · object[]"},"message":{"example":"Not Found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["code","message","errors"],"title":"NotFoundError","type":"object","uniqueKey":"","typeLabel":"NotFoundError · object"},"examples":{"Example":{"title":"Example","value":{"code":404,"errors":[],"message":"Not Found"}}},"exampleType":"generated"}},"description":"Not Found Response","exampleType":"generated"},"9735cb14-31c2-49c5-a981-01dc7a951efd":{"content":{"application/json":{"schema":{"description":"Forbidden error","properties":{"code":{"example":403,"type":"integer","isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"errors":{"default":[],"items":{"description":"Singular error","properties":{"domain":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].domain","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"reason":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].reason","typeLabel":"string"}},"required":["domain","reason","message"],"title":"InnerError","type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"InnerError · object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"InnerError · object[]"},"message":{"example":"Forbidden","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["code","message","errors"],"title":"ForbiddenError","type":"object","uniqueKey":"","typeLabel":"ForbiddenError · object"},"examples":{"Example":{"title":"Example","value":{"code":403,"errors":[],"message":"Forbidden"}}},"exampleType":"generated"}},"description":"Internal Error Response","exampleType":"generated"}},"security":{"48248fe8-3acb-4be1-b40f-8384723ebc05":{"BearerAuth":{"bearerFormat":"JWT","description":"Bearer token for authentication","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"9052e5c0-34df-47d4-8603-693bab08bcc0":{"description":"Twine Public Production API","url":"https://api.twine.se","variables":{}},"c9338b87-25eb-4aa8-b3fe-b99dae164f43":{"description":"Twine Public Staging API","url":"https://api-stage.twine.se","variables":{}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"JWT","description":"Bearer token for authentication","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer token for authentication","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"https://api.twine.se/spec/openapi.json"},"subdomain":"entwineab","siteName":"Twine Integrations","title":"Get File Transfer - Twine Integrations","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-14T11:25:10.291Z","originalFileLocation":"api-reference/file-transfers/get-file-transfer.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=\"Fetch a single file transfer. This is the endpoint to poll after uploading: status stays pending until the target system has accepted the file, at which point it becomes delivered and remote_id holds the identifier the target assigned.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Twine Integrations\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/entwineab/8LV-a3cLiAT4An4I/_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/entwineab/8LV-a3cLiAT4An4I/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/entwineab/8LV-a3cLiAT4An4I/_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/entwineab/8LV-a3cLiAT4An4I/_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/entwineab/8LV-a3cLiAT4An4I/_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/entwineab/8LV-a3cLiAT4An4I/_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/entwineab/8LV-a3cLiAT4An4I/_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/entwineab/8LV-a3cLiAT4An4I/_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/entwineab/8LV-a3cLiAT4An4I/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get File Transfer - Twine Integrations\">\u003cmeta data-mint-head property=\"og:description\" content=\"Fetch a single file transfer. This is the endpoint to poll after uploading: status stays pending until the target system has accepted the file, at which point it becomes delivered and remote_id holds the identifier the target assigned.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Twine Integrations\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.twine.se/api-reference/file-transfers/get-file-transfer\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://entwineab.mintlify.app/_mintlify/api/og/v2?division=File+Transfers\u0026amp;title=Get+File+Transfer\u0026amp;description=Fetch+a+single+file+transfer.+This+is+the+endpoint+to+poll+after+uploading%3A+%60status%60+stays+%60pending%60+until+the+target+system+has+accepted+the+file%2C+at+which+poi\u0026amp;theme=30a0ce2375f0bc6afd332c94\u0026amp;signature=7cc00a26a43665c06d7b8c5d56962c50286e7e75f49212644bfd953856b97529\">\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 File Transfer - Twine Integrations\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Fetch a single file transfer. This is the endpoint to poll after uploading: status stays pending until the target system has accepted the file, at which point it becomes delivered and remote_id holds the identifier the target assigned.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://entwineab.mintlify.app/_mintlify/api/og/v2?division=File+Transfers\u0026amp;title=Get+File+Transfer\u0026amp;description=Fetch+a+single+file+transfer.+This+is+the+endpoint+to+poll+after+uploading%3A+%60status%60+stays+%60pending%60+until+the+target+system+has+accepted+the+file%2C+at+which+poi\u0026amp;theme=30a0ce2375f0bc6afd332c94\u0026amp;signature=7cc00a26a43665c06d7b8c5d56962c50286e7e75f49212644bfd953856b97529\">\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/entwineab/8LV-a3cLiAT4An4I/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Twine Integrations\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7600ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.twine.se/api-reference/file-transfers/get-file-transfer\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/file-transfers/get-file-transfer.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.twine.se/#organization\",\"name\":\"Twine Integrations\",\"url\":\"https://docs.twine.se\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/entwineab/W0WCY-b2dvTokvLn/logo/light.svg?fit=max\u0026auto=format\u0026n=W0WCY-b2dvTokvLn\u0026q=85\u0026s=7e70d0ec35e8816f98a512eafa2ad35b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.twine.se#website\",\"name\":\"Twine Integrations\",\"url\":\"https://docs.twine.se\",\"publisher\":{\"@id\":\"https://docs.twine.se/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.twine.se/api-reference/file-transfers/get-file-transfer#webpage\",\"url\":\"https://docs.twine.se/api-reference/file-transfers/get-file-transfer\",\"name\":\"Get File Transfer\",\"description\":\"Fetch a single file transfer. This is the endpoint to poll after uploading: status stays pending until the target system has accepted the file, at which point it becomes delivered and remote_id holds the identifier the target assigned.\",\"dateModified\":\"2026-10-14T11:25:10.291Z\",\"isPartOf\":{\"@id\":\"https://docs.twine.se#website\"},\"breadcrumb\":{\"@id\":\"https://docs.twine.se/api-reference/file-transfers/get-file-transfer#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.twine.se/api-reference/file-transfers/get-file-transfer#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.twine.se/api-reference/users/get-users\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"File Transfers\",\"item\":\"https://docs.twine.se/api-reference/file-transfers/get-file-transfers\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get File Transfer\",\"item\":\"https://docs.twine.se/api-reference/file-transfers/get-file-transfer\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.twine.se/api-reference/file-transfers/get-file-transfer#apireference\",\"headline\":\"Get File Transfer\",\"name\":\"Get File Transfer\",\"description\":\"Fetch a single file transfer. This is the endpoint to poll after uploading: status stays pending until the target system has accepted the file, at which point it becomes delivered and remote_id holds the identifier the target assigned.\",\"url\":\"https://docs.twine.se/api-reference/file-transfers/get-file-transfer\",\"mainEntityOfPage\":{\"@id\":\"https://docs.twine.se/api-reference/file-transfers/get-file-transfer#webpage\"},\"dateModified\":\"2026-10-14T11:25:10.291Z\",\"publisher\":{\"@id\":\"https://docs.twine.se/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.twine.se#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Twine Integrations\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Twine Integrations","nav":{"global":{"anchors":[{"anchor":"twine.se","icon":"globe","href":"https://www.twine.se"}]},"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":"/overview"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations"}]},{"tab":"Platform","pages":[{"title":"Platform","href":"/platform"}]},{"tab":"Backoffice","pages":[{"title":"Backoffice","href":"/backoffice"}]},{"tab":"Flow Engine","pages":[{"title":"Flow Engine","href":"/flow-engine"}]},{"tab":"Data Engine","pages":[{"title":"Data Engine","href":"/data-engine"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Provisioning","href":"/api-reference/provisioning"},{"title":"Filtering and ordering","href":"/api-reference/filtering-and-ordering"},{"title":"Pushing data","href":"/api-reference/pushing-data"}]},{"group":"API Reference","pages":[{"group":"Users","pages":[{"title":"Get Users","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/users","href":"/api-reference/users/get-users"}]},{"group":"Competences","pages":[{"title":"Get Competence","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/competences/{competence_id}","href":"/api-reference/competences/get-competence"},{"title":"Replace Competence","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json put /v1/org/competences/{competence_id}","href":"/api-reference/competences/replace-competence"},{"title":"Delete Competence","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json delete /v1/org/competences/{competence_id}","href":"/api-reference/competences/delete-competence"},{"title":"Update Competence","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json patch /v1/org/competences/{competence_id}","href":"/api-reference/competences/update-competence"},{"title":"Get Competences","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/competences","href":"/api-reference/competences/get-competences"},{"title":"Create Competence","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/competences","href":"/api-reference/competences/create-competence"}]},{"group":"Organizations","pages":[{"title":"Get organizations","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org","href":"/api-reference/organizations/get-organizations"},{"title":"Create organization","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org","href":"/api-reference/organizations/create-organization"},{"title":"Get organization","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/{org_id}","href":"/api-reference/organizations/get-organization"}]},{"group":"DomainMappings","pages":[{"title":"Delete Domain Mapping Sync Trigger","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json delete /v1/org/domain-mappings/{domain_mapping_id}/sync-triggers/{sync_trigger_id}","href":"/api-reference/domainmappings/delete-domain-mapping-sync-trigger"},{"title":"Fire Domain Mapping Sync Trigger","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/domain-mappings/{domain_mapping_id}/sync-triggers/{sync_trigger_id}/fire","href":"/api-reference/domainmappings/fire-domain-mapping-sync-trigger"},{"title":"Get Domain Mapping","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/domain-mappings/{domain_mapping_id}","href":"/api-reference/domainmappings/get-domain-mapping"},{"title":"Update Domain Mapping","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json put /v1/org/domain-mappings/{domain_mapping_id}","href":"/api-reference/domainmappings/update-domain-mapping"},{"title":"Delete Domain Mapping","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json delete /v1/org/domain-mappings/{domain_mapping_id}","href":"/api-reference/domainmappings/delete-domain-mapping"},{"title":"Get Domain Mappings","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/domain-mappings","href":"/api-reference/domainmappings/get-domain-mappings"},{"title":"Create Domain Mapping","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/domain-mappings","href":"/api-reference/domainmappings/create-domain-mapping"}]},{"group":"SystemIntegrations","pages":[{"title":"Get System Integration","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/system-integrations/{id}","href":"/api-reference/systemintegrations/get-system-integration"},{"title":"Update System Integration","deprecated":true,"version":null,"openapi":"https://api.twine.se/spec/openapi.json put /v1/org/system-integrations/{id}","href":"/api-reference/systemintegrations/update-system-integration"},{"title":"Partially Update System Integration","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json patch /v1/org/system-integrations/{id}","href":"/api-reference/systemintegrations/partially-update-system-integration"},{"title":"Create Credentials Link","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/system-integrations/{id}/credentials-link","href":"/api-reference/systemintegrations/create-credentials-link"},{"title":"Get System Integration Fields","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/system-integrations/{id}/fields/{domain}","href":"/api-reference/systemintegrations/get-system-integration-fields"},{"title":"Get System Integrations","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/system-integrations","href":"/api-reference/systemintegrations/get-system-integrations"},{"title":"Create System Integration","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/system-integrations","href":"/api-reference/systemintegrations/create-system-integration"}]},{"group":"File Transfers","pages":[{"title":"Get File Transfers","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/file-transfers","href":"/api-reference/file-transfers/get-file-transfers"},{"title":"Upload File","description":"Upload a file and deliver it to a target system.\n\nThe file travels through a file transfer domain mapping that has Twine as its source, so one must be configured. If your organization has exactly one, it is used automatically; otherwise name it with `domain_mapping_id` — list them with `GET /v1/org/domain-mappings` and pick the one whose `from_domain` is `file_transfer`. If none is configured at all, the upload is still recorded but nothing is sent and `status` is `undeliverable`.\n\nDelivery is asynchronous. This call returns as soon as the file is accepted, with `status` `pending` and `remote_id` null. Poll `GET /v1/org/file-transfers/{id}` until `status` becomes `delivered`, then read `remote_id` (or `remote_path`) for the identifier the target assigned — that is the value to supply when referencing the document elsewhere, for example as a competence assignment's document.\n\nTwine does not retain the uploaded file. The record of the transfer, including the target's identifier, is kept indefinitely; the file itself is removed shortly after delivery.\n\nSupply `idempotency_key` to make retries safe. Repeating a request with a key already used always returns 200 and the original transfer's id, never a duplicate record. Whether it also starts a new delivery depends on how the previous attempt ended: `delivered`, `pending` and `unknown` are returned unchanged, while `failed`, `rejected` and `undeliverable` start a fresh attempt on the same record and go back to `pending`. So a failed document can be retried under the key it already has — a retry re-sends the file posted with it, since Twine does not keep the original bytes.\n","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/file-transfers","href":"/api-reference/file-transfers/upload-file"},{"title":"Get File Transfer","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/file-transfers/{file_transfer_id}","href":"/api-reference/file-transfers/get-file-transfer"}]},{"group":"System Time Types","pages":[{"title":"Get System Time Type","description":"Used to retrieve a specific system time type by its ID within a given system integration.","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/time-reports/system-time-types/{system_integration_id}/{system_time_type_id}","href":"/api-reference/system-time-types/get-system-time-type"},{"title":"Update System Time Type","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json put /v1/org/time-reports/system-time-types/{system_integration_id}/{system_time_type_id}","href":"/api-reference/system-time-types/update-system-time-type"},{"title":"Delete System Time Type","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json delete /v1/org/time-reports/system-time-types/{system_integration_id}/{system_time_type_id}","href":"/api-reference/system-time-types/delete-system-time-type"},{"title":"Get System Time Types","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/time-reports/system-time-types/{system_integration_id}","href":"/api-reference/system-time-types/get-system-time-types"},{"title":"Create System Time Type","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/time-reports/system-time-types/{system_integration_id}","href":"/api-reference/system-time-types/create-system-time-type"}]},{"group":"EmployeeMappings","pages":[{"title":"Get Employee Mappings","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/employees/mappings","href":"/api-reference/employeemappings/get-employee-mappings"},{"title":"Create Employee Mapping","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/employees/mappings","href":"/api-reference/employeemappings/create-employee-mapping"},{"title":"Update Employee Mapping","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json put /v1/org/employees/mappings/{employee_mapping_id}","href":"/api-reference/employeemappings/update-employee-mapping"},{"title":"Delete Employee Mapping","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json delete /v1/org/employees/mappings/{employee_mapping_id}","href":"/api-reference/employeemappings/delete-employee-mapping"}]},{"group":"Time Reports","pages":[{"title":"Get Time Reports","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/time-reports","href":"/api-reference/time-reports/get-time-reports"},{"title":"Create Time Report","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/time-reports","href":"/api-reference/time-reports/create-time-report"},{"title":"Get Time Report","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/time-reports/{time_report_id}","href":"/api-reference/time-reports/get-time-report"},{"title":"Update Time Report","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json put /v1/org/time-reports/{time_report_id}","href":"/api-reference/time-reports/update-time-report"},{"title":"Delete Time Report","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json delete /v1/org/time-reports/{time_report_id}","href":"/api-reference/time-reports/delete-time-report"}]},{"group":"Provisioning","pages":[{"title":"Refresh token","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /provisioning/refresh-token/refresh","href":"/api-reference/provisioning/refresh-token"},{"title":"Begin refresh token process","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /provisioning/refresh-token/begin","href":"/api-reference/provisioning/begin-refresh-token-process"}]},{"group":"Systems","pages":[{"title":"Get System Fields","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/systems/{system_id}/fields/{domain}","href":"/api-reference/systems/get-system-fields"},{"title":"Get Systems","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/systems","href":"/api-reference/systems/get-systems"}]},{"group":"Organizational Units","pages":[{"title":"Get Organizational Units","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v2/org/organizational-units","href":"/api-reference/organizational-units/get-organizational-units"},{"title":"Get Organizational Unit","deprecated":true,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/organizational-units/{id}","href":"/api-reference/organizational-units/get-organizational-unit"},{"title":"Get Organizational Units","deprecated":true,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/organizational-units","href":"/api-reference/organizational-units/get-organizational-units-1"},{"title":"Get Organizational Unit","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v2/org/organizational-units/{id}","href":"/api-reference/organizational-units/get-organizational-unit-1"}]},{"group":"Jobs","pages":[{"title":"Get Job by ID","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/jobs/{job_id}","href":"/api-reference/jobs/get-job-by-id"},{"title":"Get Jobs","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/jobs","href":"/api-reference/jobs/get-jobs"}]},{"group":"DataEngine","pages":[{"title":"Get DataEngine Node Docs","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/data-engine/docs","href":"/api-reference/dataengine/get-dataengine-node-docs"}]},{"group":"Conditions","pages":[{"title":"Get Condition by ID","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/conditions/{condition_id}","href":"/api-reference/conditions/get-condition-by-id"},{"title":"Get Conditions","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/conditions","href":"/api-reference/conditions/get-conditions"}]},{"group":"Employees","pages":[{"title":"Get Employees","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/employees","href":"/api-reference/employees/get-employees"},{"title":"Create Employee","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/employees","href":"/api-reference/employees/create-employee"},{"title":"Get Employee","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/employees/{employee_id}","href":"/api-reference/employees/get-employee"},{"title":"Put Employee","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json put /v1/org/employees/{employee_id}","href":"/api-reference/employees/put-employee"},{"title":"Patch Employee","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json patch /v1/org/employees/{employee_id}","href":"/api-reference/employees/patch-employee"},{"title":"Shape Employees","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/employees/shape","href":"/api-reference/employees/shape-employees"}]},{"group":"Employee Competences","pages":[{"title":"Get Employee Competence","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/employee-competences/{employee_competence_id}","href":"/api-reference/employee-competences/get-employee-competence"},{"title":"Replace Employee Competence","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json put /v1/org/employee-competences/{employee_competence_id}","href":"/api-reference/employee-competences/replace-employee-competence"},{"title":"Delete Employee Competence","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json delete /v1/org/employee-competences/{employee_competence_id}","href":"/api-reference/employee-competences/delete-employee-competence"},{"title":"Update Employee Competence","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json patch /v1/org/employee-competences/{employee_competence_id}","href":"/api-reference/employee-competences/update-employee-competence"},{"title":"Get Employee Competences","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/employee-competences","href":"/api-reference/employee-competences/get-employee-competences"},{"title":"Create Employee Competence","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/employee-competences","href":"/api-reference/employee-competences/create-employee-competence"}]},{"group":"Salary Transactions","pages":[{"title":"Get Salary Transactions","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/salary-transactions","href":"/api-reference/salary-transactions/get-salary-transactions"},{"title":"Create Salary Transaction","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json post /v1/org/salary-transactions","href":"/api-reference/salary-transactions/create-salary-transaction"},{"title":"Get Salary Transaction","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json get /v1/org/salary-transactions/{salary_transaction_id}","href":"/api-reference/salary-transactions/get-salary-transaction"},{"title":"Replace Salary Transaction","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json put /v1/org/salary-transactions/{salary_transaction_id}","href":"/api-reference/salary-transactions/replace-salary-transaction"},{"title":"Delete Salary Transaction","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json delete /v1/org/salary-transactions/{salary_transaction_id}","href":"/api-reference/salary-transactions/delete-salary-transaction"},{"title":"Update Salary Transaction","deprecated":null,"version":null,"openapi":"https://api.twine.se/spec/openapi.json patch /v1/org/salary-transactions/{salary_transaction_id}","href":"/api-reference/salary-transactions/update-salary-transaction"}]}]}]}]},"title":"Get File Transfer - Twine Integrations","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DKJwRUt2.js","utils-CWD_VS3u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-oFjciODD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C76WsxC3.js","snippetPresets-DvPMxpX_.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CuNQfndH.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BVFpVUoF.js","shallow-t59Jg5Kr.js","getApiPlaygroundDisplay-C_JZ4amX.js","CodeSnippet-CLRDnx_h.js","CodeSnippets-C2myU4kc.js","Page-7TwLLapg.js","getPastedJson-B-JaVXw7.js","icon-BA-iDhH3.js","MethodPill-D4qZABFp.js","DuplicateIcon-THIDKO1O.js","createIcon-CYYJwgFd.js","DynamicMarkdown-UGQuxDKp.js","SectionHeading-jYELb23h.js","axios-vUo_bRtp.js","Markdown-DKsLa3wy.js","clsx-CefdjKz2.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BaREnp3o.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-sgx_0XzF.js"]}