curl -X POST 'https://prod.visionapi.unsiloed.ai/parse/excel' \
  -H 'accept: application/json' \
  -H 'api-key: your-api-key' \
  -H 'Content-Type: multipart/form-data' \
  -F 'file=@workbook.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' \
  -F 'exclude_hidden=true' \
  -F 'split_large_tables=true' \
  -F 'max_rows_per_segment=100' \
  -F 'table_clustering=accurate'

# Alternative: presigned / public URL instead of file upload
# -F 'url=https://your-bucket.s3.amazonaws.com/workbook.xlsx?signature=...'

import requests

url = "https://prod.visionapi.unsiloed.ai/parse/excel"
headers = {"accept": "application/json", "api-key": "your-api-key"}

files = {"file": ("workbook.xlsx", open("workbook.xlsx", "rb"),
                  "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet")}

data = {
    "exclude_hidden": "true",
    "split_large_tables": "true",
    "max_rows_per_segment": "100",
    "table_clustering": "accurate",
}

response = requests.post(url, headers=headers, files=files, data=data)

if response.status_code == 200:
    result = response.json()
    print(f"Job ID: {result['job_id']}")
    print(f"Status: {result['status']}")
    print(f"Credit used: {result['credit_used']}")
else:
    print("Error:", response.status_code, response.text)

files["file"][1].close()

# ========== Alternative: Use Presigned URL ==========
# data = {
#     "url": "https://your-bucket.s3.amazonaws.com/workbook.xlsx?signature=...",
#     "exclude_hidden": "true",
# }
# response = requests.post(url, headers=headers, data=data)

const formData = new FormData();

const fileInput = document.querySelector('input[type="file"]');
if (fileInput.files[0]) {
  formData.append('file', fileInput.files[0]);
}

formData.append('exclude_hidden', 'true');
formData.append('split_large_tables', 'true');
formData.append('max_rows_per_segment', '100');
formData.append('table_clustering', 'accurate');

const response = await fetch('https://prod.visionapi.unsiloed.ai/parse/excel', {
  method: 'POST',
  headers: {
    'accept': 'application/json',
    'api-key': 'your-api-key',
  },
  body: formData,
});

if (response.ok) {
  const result = await response.json();
  console.log(`Job ID: ${result.job_id}`);
  console.log(`Status: ${result.status}`);
} else {
  console.error('Parsing failed:', response.status, await response.text());
}

// ========== Alternative: Use Presigned URL ==========
// formData.append('url', 'https://your-bucket.s3.amazonaws.com/workbook.xlsx?signature=...');

{
  "job_id": "9b1f7a04-2c33-4f8e-9c92-6f8a2e84b3d1",
  "status": "Starting",
  "file_name": "workbook.xlsx",
  "created_at": "2026-06-17T14:22:08.901234Z",
  "message": "Task created successfully. Use GET /parse/{job_id} to check status and retrieve results.",
  "credit_used": 3,
  "quota_remaining": 23692,
  "merge_tables": false
}

Bad request: file is not a supported Excel format (.xls / .xlsx).

Either file or url must be provided

{
  "message": "Insufficient quota",
  "status": "INSUFFICIENT_QUOTA",
  "quota_data": {
    "remaining": 0
  }
}

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit of 10 requests per second exceeded. Retry after 1s.",
  "retry_after": 1
}

Service unavailable: job queue is at capacity. Retry after the duration indicated in the Retry-After header.