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

# Retrieve a file

`GET /v2/files/{id}`

## Request

- Base URL: `https://api.sandbox.lead.bank`
- URL: `https://api.sandbox.lead.bank/v2/files/{id}`
- Auth: HTTP bearer

Retrieve a File's metadata by its ID. No bytes or download URL are returned.

## Path parameters

- `id` string, required: Lead-issued identifier of the file, from `POST /v2/files`.

## Response `200`

The file's metadata.

- File
  - `id` string: Unique ID of the file. Use this to link the file to Entity, Application and User Account objects.
  - `uploaded_by` 'partner' | 'lead': Who created the file. Set by Lead, not declarable on upload. * `partner`: created by you through the files API. * `lead`: reserved for files Lead itself creates.
  - `file_name` string: The filename you declared, taken from the uploaded part's `filename` header.
  - `type` string: The file's type. Must be a valid enum. The accepted values are grouped by the object the file can be linked to. **Application and User Account** `ach_authorization`, `adverse_action_notice`, `autopay_authorization_agreement`, `beneficial_ownership_document`, `cardholder_agreement`, `credit_agreement`, `deposit_agreement`, `electronic_signature_agreement`, `lead_funds_transfer_agreement`, `lead_privacy_policy`, `loan_agreement`, `notice_of_incompleteness`, `partner_privacy_policy`, `periodic_statement`, `personal_guarantee_agreement`, `pre_approval_terms`, `proof_of_authority`, `terms_of_use_policy`, `truth_in_lending_document` **Entity** `adverse_media`, `bank_statement`, `certificate_of_good_standing`, `consular_id`, `drivers_license`, `financial_statement`, `formation_document`, `id_selfie`, `investigation_report`, `name_certificate`, `national_id`, `partnership_agreement`, `passport`, `permanent_residency_id`, `proof_of_address`, `proof_of_place_on_stock_exchange`, `provincial_id`, `public_record`, `social_security_card`, `source_of_wealth`, `state_id`, `tax_certificate`, `tax_return`, `utility_bill`
  - `content_type` string: MIME type of the file (e.g., application/pdf), taken from the Content-Type header of the multipart file part.
  - `size_bytes` integer: Size of the file in bytes.
  - `checksum` string: A SHA-256 checksum digest of the file bytes, computed by Lead as the file is received.
  - `created_at` string, date-time: The ISO-8601 timestamp at which the file was created.
  - `updated_at` string, date-time: The ISO-8601 timestamp at which the file was last updated.
  - `metadata` object: A set of key-value pairs that can be used to store additional information related to this object.

## Other responses

- `400`: The request could not be parsed.
- `403`: `token_invalid`: the token is missing, expired, invalid, or carries neither `file/read` nor `file/read_write`.
- `404`: No file with this `id` is visible to your program.
- `422`: The `id` did not validate: `parameters_invalid` when it does not match the `file_*` format.
- `429`: Rate limit exceeded.
- `500`: Internal server error.
- `503`: The service or endpoint is temporarily unavailable. Retry after a delay.
- `504`: An upstream system did not respond in time. Retry with backoff.

## Changes

- **2026-11-03** `2c659854496e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lead/apis/lead-bank/changes/v2/files/:id/get.md)

---

[API](https://skmtc.dev/lead/apis/lead-bank.md) - [All operations](https://skmtc.dev/lead/apis/lead-bank/llms.txt) - [OpenAPI document](https://skmtc.dev/lead/apis/lead-bank/revisions/2c659854496e?raw)