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

# Retrieve a file

`GET /files/{fileId}`

Retrieve a file by its unique ID

## Path parameters

- `fileId` string, required

## Headers

- `Account` string

## Response `200`

Successfully retrieved the given File

- File
  - `id` string — The ID of the file
  - `name` string — Name of the file
  - `type` 'Csv' | 'Jpg' | 'Png' | 'Pdf' — The type of the file
  - `category` 'Report' | 'Evidence' | 'VerificationDocument' — The category of the file
  - `metadata` object, nullable — Any additional key-value data you have attached to the file. These will be sent with any associated file events on your webhooks. You can have a maximum of 5 pieces of metadata.
  - `createdTimestamp` integer — The epoch timestamp (seconds) when the file was created
  - `lastUpdatedTimestamp` integer — The epoch timestamp (seconds) when the file was last updated
  - `sizeInBytes` integer, nullable — The size in bytes of the associated file

## Other responses

- `404` — The given resource could not be found
- `500` — An unexpected error occurred when executing this request

---

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