---
title: "List files"
method: GET
path: "/files"
tags: ["Files"]
---

# List files

`GET /files`

Used to fetch a paginated list of files under your account

## Query parameters

- `category` 'Evidence' | 'VerificationDocument' | 'Report'
- `ascending` boolean
- `limit` integer
- `startsAfter` string

## Response `200`

Successfully retrieved the files

- Files
  - `items` 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
  - `paginationToken` string, nullable — A token to use for getting the next page of results - send the same request with this value in the 'paginationToken' query parameter. This field is null when there are no further items to return

## Other responses

- `400` — One or more inputs are invalid
- `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)