> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moorcheh.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get File

> Get one indexed file record by file_id.

## Overview

Returns a single file registry entry for a text namespace.

## Path parameters

<ParamField path="namespace_name" type="string" required>
  Text namespace.
</ParamField>

<ParamField path="file_id" type="string" required>
  File id from [List files](/on-prem/api-references/files/list) or a file upload job.
</ParamField>

## Request example

```bash theme={null}
curl "http://localhost:8080/namespaces/my-documents/files/a1b2c3d4e5f67890"
```

## Response fields

<ResponseField name="status" type="string">
  `"success"` on success.
</ResponseField>

<ResponseField name="file" type="object">
  Same fields as each entry in [List files](/on-prem/api-references/files/list).
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "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" }
    }
  }
  ```
</ResponseExample>

## Errors

| HTTP | Cause                            |
| ---- | -------------------------------- |
| 404  | Namespace or `file_id` not found |

## Related

* [CLI: moorcheh file-get](/on-prem/cli/files/file-get)
* [Python: files.get()](/on-prem/python-client/files/file-get)