Translation APIReference
v2.0.0

Files

Get source file metadata and analysis state

Return file metadata and whether the uploaded source is ready to use.

GET/files/{fileId}

API key permission: files:read.

Parameters

NameTypeDescription
fileIdstring · required

path parameter

Standard response headers

HeaderExampleDescription
Stepes-Request-Idb09de4aa-3874-4991-b85c-0bc86e780511

Server-generated request identifier for support and audit correlation.

Stepes-API-Version2.0.0

Effective Stepes API semantic version.

RateLimit-Policy120;w=60

Effective request limit and window for the authenticated key.

RateLimitlimit=120, remaining=119, reset=60

Current limit, remaining requests, and reset interval.

Responses

200

File

404

Resource was not found or is not available to this API key

{
  "id": "string",
  "object": "file",
  "filename": "string",
  "mime_type": "string",
  "size": 1,
  "checksum_sha256": "string",
  "status": "ready",
  "analysis": {},
  "created_at": "2026-07-23T12:00:00Z"
}