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

# Get a file

`GET /files/{id}`

## Request

- Base URL: `https://www.happyscribe.com/api/v1`
- URL: `https://www.happyscribe.com/api/v1/files/{id}`
- Auth: API key in header `Authorization`

Any key that belongs to the file's workspace can read it. The `url` is signed again on every read.

## Response `200`

The file.

- File
  - `id` string, required: File ID, beginning with `file_`.
  - `object` string, required: Always `file`.
  - `purpose` 'brand_kit', required: What the file is for. `brand_kit`: an image for a brand kit.
  - `workspace_id` string, required: The workspace the file belongs to, a `wks_` id.
  - `filename` string, required: The name the file was uploaded with. Its extension is replaced when it does not match the image type.
  - `content_type` 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp' | 'image/svg+xml', required: The image type, read from the file's bytes. - `image/png`: PNG. - `image/jpeg`: JPEG. - `image/gif`: GIF. - `image/webp`: WebP. - `image/svg+xml`: SVG.
  - `size` integer, required: Size in bytes.
  - `url` string, uri, required: A signed URL to download the file, valid for one year. Every read returns a fresh one. An SVG is served as a download, never inline.
  - `created_at` string, date-time, required: When the file was uploaded, in ISO 8601.

## Other responses

- `401`: Your API key is missing (`missing_api_key`) or wrong (`invalid_api_key`), or it may not access this resource (`unauthorized`).
- `404`: No workspace the key belongs to has this file.

---

[API](https://skmtc.dev/happyscribe/apis/happyscribe-api.md) - [All operations](https://skmtc.dev/happyscribe/apis/happyscribe-api/llms.txt) - [OpenAPI document](https://skmtc.dev/happyscribe/apis/happyscribe-api/revisions/1281bd968c3d?raw)