# List files

Used to fetch a paginated list of files under your account

Endpoint: GET /files
Version: 1.1.0
Security: secretApiKeyAuth

## Query parameters:

  - `category` (string)
    Filter for files in a specific category.
    Enum: "Evidence", "VerificationDocument", "Report"

  - `ascending` (boolean)
    Control the order (newest or oldest) in which the files are returned. false will arrange the results with newest first, whereas true shows oldest first. The default is false.

  - `limit` (integer)
    Control how many items are return in a given page The max limit we allow is 25. The default is 10.
    Example: 10

  - `startsAfter` (string)
    A token to identify where to resume a subsequent paginated query. The value of the paginationToken field from that response should be supplied here, to retrieve the next page of results for that timestamp range.
    Example: "fl_01FCTS1XMKH9FF43CAFA4CXT3P_1641912473"

## Response 200 fields (application/json):

  - `items` (array)

  - `items.id` (string)
    The ID of the file
    Example: "fl_01G0EYVFR02KBBVE2YWQ8AKMGJ"

  - `items.name` (string)
    Name of the file
    Example: "receipt_2024.png"

  - `items.type` (string)
    The type of the file
    Enum: "Csv", "Jpg", "Png", "Pdf"

  - `items.category` (string)
    The category of the file
    Enum: "Report", "Evidence", "VerificationDocument"

  - `items.metadata` (object,null)
    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.
    Example: {"customerId":"1","registered":"123"}

  - `items.createdTimestamp` (integer)
    The epoch timestamp (seconds) when the file was created
    Example: 1470989538

  - `items.lastUpdatedTimestamp` (integer)
    The epoch timestamp (seconds) when the file was last updated
    Example: 1470989538

  - `items.sizeInBytes` (integer,null)
    The size in bytes of the associated file
    Example: 2048

  - `paginationToken` (string)
    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
    Example: "fl_01FCTS1XMKH9FF43CAFA4CXT3P_1641912473"

## Response 400 fields (application/json):

  - `requestId` (string)
    Example: "b83f2653-06d7-44a9-a548-5825e8186004"

  - `code` (string)
    Example: "400"

  - `errors` (array)

  - `errors.message` (string)
    Example: "Required property 'amount' not found in JSON"

## Response 500 fields (application/json):

  - `requestId` (string)
    Example: "b83f2653-06d7-44a9-a548-5825e8186004"

  - `code` (string)
    Example: "400"

  - `errors` (array)

  - `errors.message` (string)
    Example: "Required property 'amount' not found in JSON"