# Retrieve a file

Retrieve a file by its unique ID

Endpoint: GET /files/{fileId}
Version: 1.1.0
Security: secretApiKeyAuth

## Path parameters:

  - `fileId` (string, required)
    File to retrieve
    Example: "fl_01FCTS1XMKH9FF43CAFA4CXT3P"

## Header parameters:

  - `Account` (string)
    The linked accountId (use this if you need to fetch a particular file for a sub account)
    Example: "ac_3fe8398f-8cdb-43a3-9be2-806c4f84c327"

## Response 200 fields (application/json):

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

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

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

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

  - `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"}

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

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

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

## Response 404 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"