---
title: "Get file request"
method: GET
path: "/file_requests/{file_request_id}"
tags: ["File requests"]
---

# Get file request

`GET /file_requests/{file_request_id}`

Retrieves the information about a file request.

## Path parameters

- `file_request_id` string, required

## Response `200`

Returns a file request object.

- FileRequest — A standard representation of a file request, as returned from any file request API endpoints by default.
  - `id` string, required — The unique identifier for this file request.
  - `type` 'file_request', required — The value will always be `file_request`.
  - `title` string — The title of file request. This is shown in the Box UI to users uploading files. This defaults to title of the file request that was copied to create this file request.
  - `description` string, nullable — The optional description of this file request. This is shown in the Box UI to users uploading files. This defaults to description of the file request that was copied to create this file request.
  - `status` 'active' | 'inactive' — The status of the file request. This defaults to `active`. When the status is set to `inactive`, the file request will no longer accept new submissions, and any visitor to the file request URL will receive a `HTTP 404` status code. This defaults to status of file request that was copied to create this file request.
  - `is_email_required` boolean — Whether a file request submitter is required to provide their email address. When this setting is set to true, the Box UI will show an email field on the file request form. This defaults to setting of file request that was copied to create this file request.
  - `is_description_required` boolean — Whether a file request submitter is required to provide a description of the files they are submitting. When this setting is set to true, the Box UI will show a description field on the file request form. This defaults to setting of file request that was copied to create this file request.
  - `expires_at` string, date-time — The date after which a file request will no longer accept new submissions. After this date, the `status` will automatically be set to `inactive`.
  - `folder` object, required — The folder that this file request is associated with. Files submitted through the file request form will be uploaded to this folder.
    - `id` string, required — The unique identifier that represent a folder. The ID for any folder can be determined by visiting a folder in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/folders/123` the `folder_id` is `123`.
    - `etag` string, nullable — The HTTP `etag` of this folder. This can be used within some API endpoints in the `If-Match` and `If-None-Match` headers to only perform changes on the folder if (no) changes have happened.
    - `type` 'folder', required — The value will always be `folder`.
    - `sequence_id` string — A numeric identifier that represents the most recent user event that has been applied to this item. This can be used in combination with the `GET /events`-endpoint to filter out user events that would have occurred before this identifier was read. An example would be where a Box Drive-like application would fetch an item via the API, and then listen to incoming user events for changes to the item. The application would ignore any user events where the `sequence_id` in the event is smaller than or equal to the `sequence_id` in the originally fetched resource.
    - `name` string — The name of the folder.
  - `url` string — The generated URL for this file request. This URL can be shared with users to let them upload files to the associated folder.
  - `etag` string, nullable — The HTTP `etag` of this file. This can be used in combination with the `If-Match` header when updating a file request. By providing that header, a change will only be performed on the file request if the `etag` on the file request still matches the `etag` provided in the `If-Match` header.
  - `created_by` object — The user who created this file request.
    - `id` string, required — The unique identifier for this user.
    - `type` 'user', required — The value will always be `user`.
    - `name` string — The display name of this user.
    - `login` string, email — The primary email address of this user.
  - `created_at` string, date-time, required — The date and time when the file request was created.
  - `updated_by` object — The user who last modified this file request.
    - `id` string, required — The unique identifier for this user.
    - `type` 'user', required — The value will always be `user`.
    - `name` string — The display name of this user.
    - `login` string, email — The primary email address of this user.
  - `updated_at` string, date-time, required — The date and time when the file request was last updated.

## Other responses

- `401` — Returned when the access token provided in the `Authorization` header is not recognized or not provided.
- `404` — Returned if the file request is not found, or the user does not have access to the associated folder.
- `405` — Returned if the `file_request_id` is not in a recognized format.
- `default` — An unexpected client error.

---

[API](https://skmtc.net/box/apis/platform-api.md) · [All operations](https://skmtc.net/box/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/box/platform-api/revisions/ba8f087e1a4d/schema)