Retrieve File Metadata

gravixlayer files info file-abc123def456

gravixlayer files info document.pdf

File Information:

File ID: file-abc123def456
Filename: document.pdf
Size: 2048576 bytes
Purpose: batch
Created: 2025-09-03T15:57:47.021738Z
Status: processed

import os
from gravixlayer import GravixLayer

client = GravixLayer()

# Get details for multiple files
file_ids = ["file-abc123", "file-def456", "file-ghi789"]

for file_id in file_ids:
    try:
        file_info = client.files.retrieve(file_id)
        print(f"File: {file_info.filename}")
        print(f"  Size: {file_info.bytes} bytes")
        print(f"  Purpose: {file_info.purpose}")
        print(f"  Status: {file_info.status}")
        print("---")
    except Exception as e:
        print(f"Error retrieving {file_id}: {e}")

import os
from gravixlayer import GravixLayer

client = GravixLayer()

def check_file_status(file_id):
    try:
        file_info = client.files.retrieve(file_id)
        status = file_info.status
        
        if status == "processed":
            print(f"✅ File {file_info.filename} is ready for use")
        elif status == "processing":
            print(f"⏳ File {file_info.filename} is still processing")
        elif status == "error":
            print(f"❌ File {file_info.filename} failed to process")
        else:
            print(f"ℹ️ File {file_info.filename} status: {status}")
            
        return status
    except Exception as e:
        print(f"Error checking file status: {e}")
        return None

# Check status of a file
file_status = check_file_status("your-file-id")