Skip to main content
GET /v1/files/{file_id} Retrieves the detailed metadata for a single file by file ID.

​
Path parameters

ParameterTypeRequiredDescription
file_idstringYesFile unique identifier with the file_ prefix

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer $QODER_PAT

​
Example request

curl -X GET "https://api.qoder.com/api/v1/cloud/files/file_019e3bb8c1387743bf4ef115aae5acb1" \
  -H "Authorization: Bearer $QODER_PAT"

​
Example response

HTTP 200 OK 
{
  "created_at": "2026-05-18T15:33:44Z",
  "file_id": "file_019e3bb8c1387743bf4ef115aae5acb1",
  "filename": "qoder-test-upload.txt",
  "metadata": {},
  "mime_type": "text/plain",
  "purpose": "session_resource",
  "size_bytes": 110,
  "status": "ready",
  "updated_at": "2026-05-18T15:33:44Z"
}

​
Response fields

FieldTypeDescription
file_idstringFile unique identifier
filenamestringOriginal filename
size_bytesintegerFile size in bytes
mime_typestringMIME type
purposestringFile purpose
statusstringFile status (ready indicates available)
metadataobjectCustom metadata
created_atstringCreation time (ISO 8601)
updated_atstringLast update time (ISO 8601)

​
Errors

HTTPTypeTrigger
401–Missing or invalid authentication token
404not_found_errorFile with the given ID does not exist

​
Error response example

{
  "error": {
    "message": "File 'file_nonexistent123' was not found.",
    "type": "not_found_error"
  },
  "type": "error"
}
See Errors for the full error envelope.