> ## Documentation Index
> Fetch the complete documentation index at: https://nusaai-edit.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get File

Retrieve metadata information about a specific uploaded file.

<ParamField path="file_id" type="string" required>
  The ID of the file to retrieve (e.g., `file-abc123`).
</ParamField>

### Returns

<ResponseField name="id" type="string">
  The unique identifier of the file.
</ResponseField>

<ResponseField name="object" type="string">
  The object type, which is always `file`.
</ResponseField>

<ResponseField name="bytes" type="integer">
  The size of the file in bytes.
</ResponseField>

<ResponseField name="created_at" type="integer">
  The Unix timestamp (in seconds) of when the file was created.
</ResponseField>

<ResponseField name="filename" type="string">
  The name of the file.
</ResponseField>

<ResponseField name="purpose" type="string">
  The purpose of the file.
</ResponseField>

<ResponseField name="status" type="string">
  The current status of the file.
</ResponseField>

<ResponseField name="status_details" type="string or null">
  Additional details about the file status.
</ResponseField>

### Return Examples

```json Response 200 theme={null}
{
  "id": "file-abc123",
  "object": "file",
  "bytes": 120000,
  "created_at": 1699564800,
  "filename": "batch_requests.jsonl",
  "purpose": "batch",
  "status": "uploaded",
  "status_details": null
}
```

```json Error 404 - File Not Found theme={null}
{
  "error": {
    "message": "File not found or access denied",
    "type": "invalid_request_error",
    "code": "file_not_found"
  }
}
```

```json Error 410 - File Expired theme={null}
{
  "error": {
    "message": "File has expired",
    "type": "invalid_request_error",
    "code": "file_expired"
  }
}
```