# Get file metadata

`GET /v1/files/{fileId}`

Required OAuth scopes: `files:read`

## Parameters

- `fileId` (path, string (uuid), required)

## Responses

- `200`
  - `file` (object, required)
    - `id` (string, required)
    - `versionId` (string (uuid))
    - `name` (string, required)
    - `mediaType` (string, required)
    - `size` (number, required)
    - `taskId` (string | null, required)
    - `projectId` (string | null, required)
    - `downloadUrl` (string (uri), required)
    - `createdAt` (string, required)
    - `updatedAt` (string, required)
- `400`: Invalid request
- `401`: Missing or invalid Bearer credential
- `402`: Payment or subscription required
- `403`: Credential is missing a required scope
- `404`: Resource not found
- `409`: Request conflict
- `429`: Rate limit exceeded
- `500`: Internal API error