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

# Retrieve a file

`GET /entities/{entityId}/files/{fileId}`

## Request

- Base URL: `https://files.checkout.com`
- URL: `https://files.checkout.com/entities/{entityId}/files/{fileId}`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `string` scopes: `files`, `files:retrieve`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/checkout/apis/checkout-com-api-reference/docs/entities/:entityId/files/:fileId/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve information about a previously uploaded file.

Please note that the sub-domain – https://files.checkout.com – is slightly different to Checkout.com's other endpoints. See the <a href="https://checkout.com/docs/platforms/onboarding/api/full/upload-a-file" target="_blank">documentation</a> for more information.

## Response `200`

OK

- PlatformsFileRetrieveResponse
  - `id` string: The ID of the file.
  - `status` string: The current status of the file.
  - `status_reasons` string[]: If `status` is `Invalid`, returns the reasons why the file was invalid. If `status` is any other value, returns `Null`.
  - `size` number: The size of the file in KB.
  - `mime_type` string: The MIME type of the file.
  - `uploaded_on` string, date-time: The date and time the file was uploaded, in ISO 8601 UTC format.
  - `purpose` 'identity_verification' | 'dispute_evidence' | 'bank_verification' | 'company_verification' | 'financial_verification' | 'tax_verification': The purpose of the file, as provided in the initial request.
  - `_links` unknown

## Other responses

- `401`: Unauthorized
- `404`: File not found

---

[API](https://skmtc.dev/checkout/apis/checkout-com-api-reference.md) - [All operations](https://skmtc.dev/checkout/apis/checkout-com-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/checkout/apis/checkout-com-api-reference/revisions/0f1abdb1c3e9?raw)