Skip to main content
GET
/
namespaces
/
{namespace_name}
/
files
/
{file_id}
Get File
curl --request GET \
  --url http://localhost:8080/namespaces/{namespace_name}/files/{file_id}
{
  "status": "success",
  "file": {
    "file_id": "a1b2c3d4e5f67890",
    "absolute_path": "/uploads/document.pdf",
    "filename": "document.pdf",
    "file_type": ".pdf",
    "file_size": 125440,
    "file_mtime": "2026-06-05T18:50:08Z",
    "chunk_count": 3,
    "summary_count": 1,
    "status": "indexed",
    "path_exists": true,
    "ingested_at": "2026-06-05T18:50:20Z",
    "last_error": null,
    "metadata": { "department": "engineering" }
  }
}

​
Overview

Returns a single file registry entry for a text namespace.

​
Path parameters

​
namespace_name
string
required
Text namespace.
​
file_id
string
required
File id from List files or a file upload job.

​
Request example

curl "http://localhost:8080/namespaces/my-documents/files/a1b2c3d4e5f67890"

​
Response fields

​
status
string
"success" on success.
​
file
object
Same fields as each entry in List files.
{
  "status": "success",
  "file": {
    "file_id": "a1b2c3d4e5f67890",
    "absolute_path": "/uploads/document.pdf",
    "filename": "document.pdf",
    "file_type": ".pdf",
    "file_size": 125440,
    "file_mtime": "2026-06-05T18:50:08Z",
    "chunk_count": 3,
    "summary_count": 1,
    "status": "indexed",
    "path_exists": true,
    "ingested_at": "2026-06-05T18:50:20Z",
    "last_error": null,
    "metadata": { "department": "engineering" }
  }
}

​
Errors

HTTPCause
404Namespace or file_id not found