---
title: "Retrieve file information"
method: GET
path: "/file/{token}"
tags: ["Files"]
---

# Retrieve file information

`GET /file/{token}`

Retrieves file information for the file identified by the specified token.

## Headers

- `Accept` 'application/vnd.Creative Force.v2.3+json' | 'application/vnd.Creative Force.v2.3+xml', required
- `x-api-language` string[]

## Response `200`

File information retrieved.

- File
  - `download_link` string — Download URL for the file.
  - `duration` number, nullable — Duration of the file in seconds, or `null` for files without a duration (such as images and documents).
  - `filename` string — Name of the file.
  - `image_height` integer, nullable — Height of the image in pixels, or `null` when not available.
  - `image_width` integer, nullable — Width of the image in pixels, or `null` when not available.
  - `metadata` object — Metadata associated with the file.
    - `title` string — Metadata title.
    - `caption` string — Metadata caption.
    - `copyright` string — Metadata copyright notice.
    - `created` string — Metadata creation time.
    - `city` string — Metadata city.
    - `country` string — Metadata country.
    - `state` string — Metadata state.
    - `camera` string — Camera model in the metadata.
    - `exposure` string — Exposure setting in the metadata.
    - `iso` string — ISO setting in the metadata.
    - `fstop` string — F-stop setting in the metadata.
    - `focal_length` string — Focal length in the metadata.
    - `size` string — Size value in the metadata.
  - `mime` string — MIME type of the file.
  - `size` integer — Size of the file.
  - `transcoding` object[] — Transcoded file variants. Empty when the file is not a video.
    - `basename` string — Basename of the transcoded file.
    - `download_link` string — Download URL for the transcoded file.
    - `extension` string — File extension of the transcoded file.
    - `timestamp` integer — Unix timestamp, in seconds since the epoch, of the last modification of the transcoded file.
    - `size` integer — Size of the transcoded file.
    - `etag` string — ETag of the transcoded file.

## Other responses

- `400` — Request was rejected before the endpoint could process it. Common causes: invalid `Accept` header, unsupported `x-api-language` code, empty request body on `POST` / `PUT`, invalid JSON in the request body, or an invalid slug format in a path parameter.
- `401` — Missing `x-api-key` header.
- `403` — Authenticated request denied. Common causes: invalid or unknown API key, suspended account, or `api` feature not enabled for the account.
- `404` — Resource identified by the path slug does not exist. Returned when the slug is well-formed but no record matches it.
- `429` — Rate limit of 60 requests per minute exceeded.
- `503` — Service is temporarily unavailable due to regional maintenance.

## Changes

- **2026-07-07** (v2) `9b9103538ceb` — 2 info
  - api tag `Files` added
  - api tag `File` removed
- **2026-07-01** (v2) `e96a96d4507e` — 7 info
  - added the media type `application/xml` for the response with the status `200`
  - added the media type `application/xml` for the response with the status `400`
  - added the media type `application/xml` for the response with the status `401`
  - added the media type `application/xml` for the response with the status `403`
  - …3 more

[Change history](https://skmtc.dev/tectonic/apis/award-force-api/changes/file/:token/get.md)

---

[API](https://skmtc.dev/tectonic/apis/award-force-api.md) · [All operations](https://skmtc.dev/tectonic/apis/award-force-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tectonic/award-force-api/revisions/e2511e46f9f2/schema)