Get File Metadata

Get metadata for a file without downloading

GET /api/v1/files/{file_id}/metadata

cURL

curl "https://api.fileguard.io/api/v1/files/file_z1x2c3v4b5n6/metadata" \
  -H "Authorization: Bearer fg_your_api_key"

200 OK

{
  "status": "SUCCESS",
  "data": {
    "file_id": "file_z1x2c3v4b5n6",
    "original_filename": "blood_test.pdf",
    "content_type": "application/pdf",
    "size_bytes": 245678,
    "context_key": "patient_reports",
    "checksum": "sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "metadata": {},
    "download_count": 47,
    "last_downloaded_at": "2026-01-16T10:30:00Z",
    "created_at": "2026-01-04T10:00:00Z",
    "updated_at": "2026-01-04T10:00:00Z"
  },
  "timestamp": "2026-01-04T10:00:00Z"
}

Retrieve detailed metadata for a specific file.

Path Parameters

file_id · string · required

Unique file identifier

Response

data · object

Show properties

file_id · string

Unique file identifier

original_filename · string

Original filename from upload

content_type · string

MIME content type

size_bytes · integer

File size in bytes

context_key · string

File context key

checksum · string

SHA-256 checksum

download_count · integer

Total download count

last_downloaded_at · datetime

Last download timestamp

metadata · object

Custom metadata

created_at · datetime

Upload timestamp

updated_at · datetime

Last update timestamp

cURL

curl "https://api.fileguard.io/api/v1/files/file_z1x2c3v4b5n6/metadata" \
  -H "Authorization: Bearer fg_your_api_key"

200 OK

{
  "status": "SUCCESS",
  "data": {
    "file_id": "file_z1x2c3v4b5n6",
    "original_filename": "blood_test.pdf",
    "content_type": "application/pdf",
    "size_bytes": 245678,
    "context_key": "patient_reports",
    "checksum": "sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "metadata": {},
    "download_count": 47,
    "last_downloaded_at": "2026-01-16T10:30:00Z",
    "created_at": "2026-01-04T10:00:00Z",
    "updated_at": "2026-01-04T10:00:00Z"
  },
  "timestamp": "2026-01-04T10:00:00Z"
}

Required Scope

Requires metadata scope on your API key.