# Retrieve a file

div
strong
🔨 In Development
 — This section is still being developed and may change.


Get details about a specific file by its ID.

Retrieve metadata and status information for a previously uploaded file.

#### Path Parameters

**`organization_id`** string required

The unique identifier of the organization.

**`file_id`** string required

The unique identifier of the file.

## Returns

A [File object](/docs/api-reference/objects/file-object) with complete file metadata.

Request

```bash
curl "https://api.freddy.aitronos.com/v1/organizations/org_abc123/files/file_abc123" \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python
from freddy import FreddyClient

with FreddyClient(api_key="your-api-key") as client:
    file = client.files.retrieve(
        organization_id="org_abc123",
        file_id="file_abc123"
    )
    
    print(f"File: {file.name}")
    print(f"Size: {file.size} bytes")
    print(f"Status: {file.status}")
```


```python
import requests

response = requests.get(
    "https://api.freddy.aitronos.com/v1/organizations/org_abc123/files/file_abc123",
    headers={"X-API-Key": api_key}
)

file = response.json()
print(f"File: {file['name']}")
```

## Response

200 OK

```json
{
  "id": "file_abc123",
  "name": "product_docs.pdf",
  "organizationId": "org_abc123",
  "size": 2457600,
  "mimeType": "application/pdf",
  "purpose": "vector_store",
  "status": "uploaded",
  "createdAt": "2025-01-20T15:30:00Z",
  "createdBy": "uid_user123"
}
```

Errors
**404 Not Found**


```json
{
  "error": {
    "message": "File not found",
    "type": "not_found_error",
    "code": "file_not_found"
  }
}
```

**401 Unauthorized**


```json
{
  "error": {
    "message": "Authentication required",
    "type": "authentication_error",
    "code": "missing_authentication"
  }
}
```

## Related Resources

- [Upload File](/docs/api-reference/files/upload)
- [List Files](/docs/api-reference/files/list)
- [Delete File](/docs/api-reference/files/delete)
- [File Object](/docs/api-reference/objects/file-object)