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

# Retrieve file status

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

Retrieves the status of the file.

## 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

- RetrieveFileStatus
  - `success` boolean — Returns `true` if the request was processed successfully.
  - `accessible` boolean — Returns `true` if the file is accessible.
  - `status` 'ACTIVE' | 'ARCHIVING' | 'ARCHIVED' | 'RESTORE_ACCEPTED' | 'RESTORE_IN_PROGRESS' | 'RESTORED' — The status of the file restore operation.

## 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)