---
title: "Get file upload"
method: GET
path: "/v1/file_uploads/{file_upload_id}"
tags: ["File Uploads"]
---

# Get file upload

`GET /v1/file_uploads/{file_upload_id}`

## Request

- Base URL: `https://api.sandbox.rainforestpay.com`
- URL: `https://api.sandbox.rainforestpay.com/v1/file_uploads/{file_upload_id}`
- Auth: HTTP bearer

Get file upload by the file upload ID.

## Path parameters

- `file_upload_id` string, required

## Parameters

- `#/paths/~1v1~1file_upload_configs/post/parameters/0` (unresolved $ref)

## Response `200`

OK

- object
  - `status` Status (unresolved $ref)
  - `data` object
    - `file_upload_id` string: The unique file upload identifier. Prefix is "fiu" in production and "sbx_fiu" in sandbox.
    - `file_upload_config_id` string: The unique file upload config identifier. Prefix is "fic" in production and "sbx_fic" in sandbox.
    - `filename` string: Name of the file.
    - `type` Type (unresolved $ref)
    - `status` 'AVAILABLE' | 'FAILED': The status of the file upload.
    - `failure_reason_code` 'INVALID_FILE' | 'INVALID_FILE_SIZE' | 'INVALID_FILE_TYPE' | 'INVALID_FILE_PROTECTED' | 'INTERNAL_ERROR': The reason a file upload failed. `INVALID_FILE`: file upload failed because the file is invalid for an unspecified reason `INVALID_FILE_SIZE`: file upload failed because it was too large (max: 25MB) `INVALID_FILE_TYPE`: file upload failed because it was not an allowed type (`image/jpeg`,`image/png`,`image/tiff`,`application/pdf`) `INVALID_FILE_PROTECTED`: file upload failed because it was password-protected `INTERNAL_ERROR`: file upload failed because an internal error
    - `created_at` CreatedAt (unresolved $ref)
    - `updated_at` CreatedAt (unresolved $ref)
  - `errors` Errors (unresolved $ref)

## Other responses

- `400` (unresolved $ref)
- `401` (unresolved $ref)
- `403` (unresolved $ref)
- `404`: Resource not found.
- `5XX` (unresolved $ref)

---

[API](https://skmtc.dev/rainforestpay/apis/file-uploads.md) - [All operations](https://skmtc.dev/rainforestpay/apis/file-uploads/llms.txt) - [OpenAPI document](https://skmtc.dev/rainforestpay/apis/file-uploads/revisions/451cd5b05877?raw)