---
title: "Retrieve a file"
method: GET
path: "/v1/files/{file-id}"
tags: ["Files"]
---

# Retrieve a file

`GET /v1/files/{file-id}`

Retrieve files such as export results, invoices, and accounting period reports.

The response content type depends on the type of file that you retrieve.
For example, if you retrieve an invoice PDF, the value of the `Content-Type`
header in the response is `application/pdf;charset=UTF-8`.

Other content types include:

- `text/csv` for CSV files
- `application/msword` for Microsoft Word files
- `application/vnd.ms-excel` and `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`
  for Microsoft Excel files (*.xls* and *.xlsx* respectively)
- `application/zip` and `application/x-gzip` for ZIP and Gzip files respectively
- `text/html` for HTML files
- `text/plain` for text files

The response always contains character encoding information in the `Content-Type` header.
For example, `Content-Type: application/zip;charset=UTF-8`.

**Note:** The maximum file size is 2,047 MB. If you have a data request that exceeds this limit, Zuora returns the following 403 response: `<security:max-object-size>2047MB</security:max-object-size>`. Submit a request at <a href="http://support.zuora.com/" target="_blank">Zuora Global Support</a> to determine if large file optimization is an option for you.

## Path parameters

- `file-id` string, required

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Response `200`

OK

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)