Files

Retrieve file information

Changed on Jul 7, 2026

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

get/file/{token}

Request

Base URL
https://api.us.cr4ce.com
Auth
API key in header x-api-key
TypeScript
https://skmtc.dev/tectonic/apis/award-force-api/docs/file/:token/get.ts
A function with typed inputs. Its response is checked against the schema.

Headers

Accept'application/vnd.Creative Force.v2.3+json' | 'application/vnd.Creative Force.v2.3+xml' required

Defines the response type.

x-api-languagestring[]

Defines the languages included in the response. If non are provided, the account default language is returned.

Value all overrides any other values present.

You can request multiple languages using a comma-separated string of languages.

The selected language must be supported by your account or a 400 error is returned.

Response

File information retrieved.

download_linkstring

Download URL for the file.

durationnumber nullable

Duration of the file in seconds, or null for files without a duration (such as images and documents).

filenamestring

Name of the file.

image_heightinteger nullable

Height of the image in pixels, or null when not available.

image_widthinteger nullable

Width of the image in pixels, or null when not available.

mimestring

MIME type of the file.

sizeinteger

Size of the file.

Example response

{
  "download_link": "https://files.au.cr4ce.com/file/AbCdEfGhIjKlMnOp/squirrel-on-log.jpg?Expires=1781485359&Signature=REDACTED&Key-Pair-Id=REDACTED",
  "duration": null,
  "filename": "squirrel-on-log.jpg",
  "image_height": null,
  "image_width": null,
  "metadata": {
    "title": "",
    "caption": "",
    "copyright": "",
    "created": "",
    "city": "",
    "country": "",
    "state": "",
    "camera": "",
    "exposure": "",
    "iso": "",
    "fstop": "",
    "focal_length": "",
    "size": "768 x 574"
  },
  "mime": "image/jpeg",
  "size": 26513,
  "transcoding": []
}

Changes

Jul 7, 2026v29b9103538ceb Revision changes
- info
  api tag Files added
- info
  api tag File removed
Jul 1, 2026v2e96a96d4507e Revision changes
- info
  added the media type application/xml for the response with the status
- info
  added the media type application/xml for the response with the status
- info
  added the media type application/xml for the response with the status
- info
  added the media type application/xml for the response with the status
- info
  added the media type application/xml for the response with the status
- info
  added the media type application/xml for the response with the status
- info
  added the media type application/xml for the response with the status

Operation history