{ "info": { "_postman_id": "b803f16b-7f0d-4c05-8cdf-efff7af41c24", "name": "Box Authorize Authorization Downloads API", "description": "Needs a description.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T01:15:56.000Z", "updatedAt": "2026-07-28T01:15:56.000Z", "lastUpdatedBy": "35240", "uid": "35240-b803f16b-7f0d-4c05-8cdf-efff7af41c24" }, "item": [ { "name": "files", "item": [ { "name": "{file_id}", "item": [ { "name": "content", "item": [ { "name": "Box Download file", "id": "a12c07ee-b474-4d19-ba9b-15f37a392356", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "description": "The byte range of the content to download.\n\nThe format `bytes={start_byte}-{end_byte}` can be used to specify\nwhat section of the file to download.", "key": "range", "value": "" }, { "description": "The URL, and optional password, for the shared link of this item.\n\nThis header can be used to access items that have not been\nexplicitly shared with a user.\n\nUse the format `shared_link=[link]` or if a password is required then\nuse `shared_link=[link]&shared_link_password=[password]`.\n\nThis header can be used on the file or folder shared, as well as on any files\nor folders nested within the item.", "key": "boxapi", "value": "" }, { "key": "Accept", "value": "application/octet-stream" } ], "url": { "raw": "{{baseUrl}}/files/:file_id/content?version=&access_token=", "host": [ "{{baseUrl}}" ], "path": [ "files", ":file_id", "content" ], "query": [ { "description": "The file version to download", "key": "version", "value": "" }, { "description": "An optional access token that can be used to pre-authenticate this request, which means that a download link can be shared with a browser or a third party service without them needing to know how to handle the authentication.\nWhen using this parameter, please make sure that the access token is sufficiently scoped down to only allow read access to that file and no other files or folders.", "key": "access_token", "value": "" } ], "variable": [ { "id": "2cb84751-278b-49da-a924-25feb6a9412f", "key": "file_id", "value": "", "description": "(Required) The unique identifier that represents a file.\n\nThe ID for any file can be determined\nby visiting a file in the web application\nand copying the ID from the URL. For example,\nfor the URL `https://*.app.box.com/files/123`\nthe `file_id` is `123`." } ] }, "description": "Returns the contents of a file in binary format." }, "response": [ { "id": "59dbbe07-b435-4147-8cea-812dce51c874", "name": "Returns the requested file if the client has the **follow\nredirects** setting enabled to automatically\nfollow HTTP `3xx` responses as redirects. If not, the request\nwill return `302` instead.\nFor details, see\nthe [download file guide](g://downloads/file#d", "originalRequest": { "method": "GET", "header": [ { "description": "The byte range of the content to download.\n\nThe format `bytes={start_byte}-{end_byte}` can be used to specify\nwhat section of the file to download.", "key": "range", "value": "" }, { "description": "The URL, and optional password, for the shared link of this item.\n\nThis header can be used to access items that have not been\nexplicitly shared with a user.\n\nUse the format `shared_link=[link]` or if a password is required then\nuse `shared_link=[link]&shared_link_password=[password]`.\n\nThis header can be used on the file or folder shared, as well as on any files\nor folders nested within the item.", "key": "boxapi", "value": "" }, { "key": "Accept", "value": "application/octet-stream" } ], "url": { "raw": "{{baseUrl}}/files/:file_id/content?version=&access_token=", "host": [ "{{baseUrl}}" ], "path": [ "files", ":file_id", "content" ], "query": [ { "description": "The file version to download", "key": "version", "value": "" }, { "description": "An optional access token that can be used to pre-authenticate this request, which means that a download link can be shared with a browser or a third party service without them needing to know how to handle the authentication.\nWhen using this parameter, please make sure that the access token is sufficiently scoped down to only allow read access to that file and no other files or folders.", "key": "access_token", "value": "" } ], "variable": [ { "key": "file_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [ { "key": "Content-Type", "value": "application/octet-stream" } ], "cookie": [], "responseTime": null, "body": "", "createdAt": "2026-07-28T01:15:57.000Z", "updatedAt": "2026-07-28T01:15:57.000Z", "uid": "35240-59dbbe07-b435-4147-8cea-812dce51c874" }, { "id": "fb178b40-dbdc-403b-aab4-66978f566e7b", "name": "If the file is not ready to be downloaded yet `Retry-After` header will\nbe returned indicating the time in seconds after which the file will\nbe available for the client to download.\n\nThis response can occur when the file was uploaded immediately before th", "originalRequest": { "method": "GET", "header": [ { "description": "The byte range of the content to download.\n\nThe format `bytes={start_byte}-{end_byte}` can be used to specify\nwhat section of the file to download.", "key": "range", "value": "" }, { "description": "The URL, and optional password, for the shared link of this item.\n\nThis header can be used to access items that have not been\nexplicitly shared with a user.\n\nUse the format `shared_link=[link]` or if a password is required then\nuse `shared_link=[link]&shared_link_password=[password]`.\n\nThis header can be used on the file or folder shared, as well as on any files\nor folders nested within the item.", "key": "boxapi", "value": "" } ], "url": { "raw": "{{baseUrl}}/files/:file_id/content?version=&access_token=", "host": [ "{{baseUrl}}" ], "path": [ "files", ":file_id", "content" ], "query": [ { "description": "The file version to download", "key": "version", "value": "" }, { "description": "An optional access token that can be used to pre-authenticate this request, which means that a download link can be shared with a browser or a third party service without them needing to know how to handle the authentication.\nWhen using this parameter, please make sure that the access token is sufficiently scoped down to only allow read access to that file and no other files or folders.", "key": "access_token", "value": "" } ], "variable": [ { "key": "file_id" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "text", "header": [ { "disabled": false, "description": { "content": "The time in seconds after which to retry the download", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:15:57.000Z", "updatedAt": "2026-07-28T01:15:57.000Z", "uid": "35240-fb178b40-dbdc-403b-aab4-66978f566e7b" }, { "id": "3f9a3eed-c47b-40a8-82d4-164bf37c705e", "name": "If the file is available for download the response will include a\n`Location` header for the file on `dl.boxcloud.com`.\n\nThe `dl.boxcloud.com` URL is not persistent and clients will need\nto follow the redirect to actually download the file.", "originalRequest": { "method": "GET", "header": [ { "description": "The byte range of the content to download.\n\nThe format `bytes={start_byte}-{end_byte}` can be used to specify\nwhat section of the file to download.", "key": "range", "value": "" }, { "description": "The URL, and optional password, for the shared link of this item.\n\nThis header can be used to access items that have not been\nexplicitly shared with a user.\n\nUse the format `shared_link=[link]` or if a password is required then\nuse `shared_link=[link]&shared_link_password=[password]`.\n\nThis header can be used on the file or folder shared, as well as on any files\nor folders nested within the item.", "key": "boxapi", "value": "" } ], "url": { "raw": "{{baseUrl}}/files/:file_id/content?version=&access_token=", "host": [ "{{baseUrl}}" ], "path": [ "files", ":file_id", "content" ], "query": [ { "description": "The file version to download", "key": "version", "value": "" }, { "description": "An optional access token that can be used to pre-authenticate this request, which means that a download link can be shared with a browser or a third party service without them needing to know how to handle the authentication.\nWhen using this parameter, please make sure that the access token is sufficiently scoped down to only allow read access to that file and no other files or folders.", "key": "access_token", "value": "" } ], "variable": [ { "key": "file_id" } ] } }, "status": "Found", "code": 302, "_postman_previewlanguage": "text", "header": [ { "disabled": false, "description": { "content": "A pointer to the download URL", "type": "text/plain" }, "key": "Location", "value": "" } ], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:15:57.000Z", "updatedAt": "2026-07-28T01:15:57.000Z", "uid": "35240-3f9a3eed-c47b-40a8-82d4-164bf37c705e" }, { "id": "e381fc53-7de2-4ecb-b0bb-1d559edd82eb", "name": "An unexpected client error.", "originalRequest": { "method": "GET", "header": [ { "description": "The byte range of the content to download.\n\nThe format `bytes={start_byte}-{end_byte}` can be used to specify\nwhat section of the file to download.", "key": "range", "value": "" }, { "description": "The URL, and optional password, for the shared link of this item.\n\nThis header can be used to access items that have not been\nexplicitly shared with a user.\n\nUse the format `shared_link=[link]` or if a password is required then\nuse `shared_link=[link]&shared_link_password=[password]`.\n\nThis header can be used on the file or folder shared, as well as on any files\nor folders nested within the item.", "key": "boxapi", "value": "" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/files/:file_id/content?version=&access_token=", "host": [ "{{baseUrl}}" ], "path": [ "files", ":file_id", "content" ], "query": [ { "description": "The file version to download", "key": "version", "value": "" }, { "description": "An optional access token that can be used to pre-authenticate this request, which means that a download link can be shared with a browser or a third party service without them needing to know how to handle the authentication.\nWhen using this parameter, please make sure that the access token is sufficiently scoped down to only allow read access to that file and no other files or folders.", "key": "access_token", "value": "" } ], "variable": [ { "key": "file_id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"type\": \"error\",\n \"status\": \"\",\n \"code\": \"forbidden\",\n \"message\": \"\",\n \"context_info\": {\n \"message\": \"\"\n },\n \"help_url\": \"\",\n \"request_id\": \"\"\n}", "createdAt": "2026-07-28T01:15:57.000Z", "updatedAt": "2026-07-28T01:15:57.000Z", "uid": "35240-e381fc53-7de2-4ecb-b0bb-1d559edd82eb" } ], "createdAt": "2026-07-28T01:15:57.000Z", "updatedAt": "2026-07-28T01:15:57.000Z", "uid": "35240-a12c07ee-b474-4d19-ba9b-15f37a392356" } ], "id": "711d6195-20da-4e25-9505-7eec580cf7e5", "createdAt": "2026-07-28T01:15:57.000Z", "updatedAt": "2026-07-28T01:15:57.000Z", "uid": "35240-711d6195-20da-4e25-9505-7eec580cf7e5" } ], "id": "a9a6b5ad-1137-4c1f-8167-777cc712a32e", "createdAt": "2026-07-28T01:15:57.000Z", "updatedAt": "2026-07-28T01:15:57.000Z", "uid": "35240-a9a6b5ad-1137-4c1f-8167-777cc712a32e" } ], "id": "c10224aa-a7b0-431b-ade3-f1d4e43a6377", "createdAt": "2026-07-28T01:15:57.000Z", "updatedAt": "2026-07-28T01:15:57.000Z", "uid": "35240-c10224aa-a7b0-431b-ade3-f1d4e43a6377" } ], "variable": [ { "key": "baseUrl", "value": "/" } ] }