# Get file metadata

> Read uploaded source metadata.

See [files and retention](https://revise.io/developer/docs/revise-api/files) for integration guidance.

## TypeScript

```ts
import { ReviseClient } from "@reviseio/api";

const revise = new ReviseClient({ apiKey: process.env.REVISE_API_KEY! });
const result = await revise.files.get("file_id");
```

`GET https://revise.io/api/v1/files/{id}`

## Authorization

`Authorization: Bearer <key>` with an API key from https://revise.io/console/api-keys.

## Path parameters

- `id` (string, required)

## Responses

### 200 `File`

Read uploaded source metadata

- `id` (string, required)
- `filename` (string, required): Empty once expired or deleted.
- `bytes` (integer, required)
- `sha256` (string, required)
- `status` (string, required): one of "uploaded", "expired", "deleted"
- `created_at` (string<date-time>, required)
- `expires_at` (string | null, required)
- `deleted_at` (string | null, required)
- `lifetime` (string, required): one of "ephemeral", "persistent"

### default `Error`

Error

- `error` (object, required)
  - `code` (string, required)
  - `message` (string, required)
  - `details` (object)
